Guide
Install a Shared Skill Safely
Vet and install a third-party skill without running instructions you have not read.
~6 min read
Skills are easy to share (a folder with a SKILL.md is the whole format), and that is exactly why installation deserves a habit. Installing a skill you have not read is running code you have not reviewed. The vetting takes five minutes.
Before it touches your skills directory
- Read the entire SKILL.md, not the README. This is the text your agent will follow. If anything in it surprises you, stop and resolve the surprise first.
- Inventory the extras. List every bundled file: scripts, templates, reference files. Open each script and understand what it touches (files, network, credentials).
- Check the trigger breadth. Read the description and ask: what requests will this catch? A description broader than the skill’s real job will hijack unrelated requests once installed.
- Look for hidden assumptions: hard-coded paths, expected credentials, services it presumes are running. A skill that names its prerequisites is a good sign; one that hides them fails on your machine in confusing ways.
Install deliberately
- Scope it: personal directory if it is for you everywhere, project directory if the team should get it with the repo, plugin if the author distributes it that way.
- Record the source and version: where it came from and which revision you reviewed. A one-line note in the folder is enough.
- Verify it landed: ask a fresh session what skills are available, then run one request that should trigger it and one that should not.
# after installing: one positive test, one negative control
> "Turn this changelog note into a release line: …" # should fire
> "Summarize this meeting transcript" # should NOT fire