Docs

Frequently Asked Questions

What skills are, how they install, what gets counted, and what does not.

9 entries
0x01What are skills?

Skills are reusable capabilities for AI agents. They provide procedural knowledge that helps agents accomplish specific tasks more effectively — here, security and compliance methodologies: how to run a pentest phase, scope PCI DSS, triage malware, review a Dockerfile, and so on. Each skill is a SKILL.md file with YAML frontmatter plus markdown instructions.

0x02How do I install a skill?

Two ways. For the whole catalog: npx skills add securityskills/skills installs all of them at once. For a single skill, copy the command from its page — each one is a direct raw URL. Either way the CLI writes plain markdown into your agent's skills directory.

0x03Which AI agents support skills?

77 at last count — Claude Code, Codex, Cursor, OpenCode, Windsurf, GitHub Copilot, Gemini CLI, Droid, Kimi, Cline, Amp, Zed and many more. They follow a shared Agent Skills specification, and the CLI auto-detects which ones you have installed. The agents reference lists every one with its -a id and install path. Note that GLM / Zhipu is not currently supported by the CLI.

0x04How do I get updates when a skill changes?

Run npx skills update to pull the latest versions of your installed skills. New installs always fetch the current contents. Update tracking is strongest for GitHub-backed sources — the lockfile records the source and its tree hash for comparison.

0x05Is any personal data collected?

No. The site collects no personal data. Download counting is anonymous and aggregate-only. The CLI's optional telemetry is separate and can be disabled with DISABLE_TELEMETRY=1 — see the CLI reference.

0x06How do I create my own skill?

Create a directory with a SKILL.md containing a name and description in the frontmatter, followed by markdown instructions for the agent. Write the description as when to use this, not as a summary — that is the text an agent matches a task against. Then submit via the submission form.

0x07How is the catalog organised on disk?

skills/<category>/<skill>/SKILL.md, or skills/<category>/<group>/<skill>/SKILL.md where a category has an axis worth splitting — cloud providers, container runtimes, compliance frameworks. Adding a provider is just adding a folder; the site picks it up at build time and turns it into a filter. Both shapes can coexist in one category.

0x08How do I report a problem with a skill?

Skills are maintained by their respective authors. Open an issue on github.com/securityskills/skills and it will be routed to the maintainer. Attribution is shown on each skill page.

0x09Are these skills safe to run?

Skills are instruction documents, not executables — nothing runs unless your agent acts on it. Every submission is reviewed for responsible-use framing (authorized testing only), and the catalog is audited. Still, read a skill before installing it, as you would any code or prompt you feed an agent.

Still stuck

Open an issue on github.com/securityskills/skills, or read the CLI reference.