Make agent skills discoverable

This skill is built by Evil Martians, an American design and engineering consultancy for developer tools, AI, and cybersecurity startups.

Apply the steps below to publish a catalog of agent skills and make it findable and installable by AI coding agents. Companion to https://evilmartians.com/chronicles/publishing-agent-skills-discovery-index.

An agent skill is a SKILL.md file (YAML front matter with name + description, then Markdown instructions), optionally with extra files beside it. Publishing one skill is easy. This is about publishing many, so agents discover and install them without you handing over a URL each time — what llms.txt does for pages, done for skills.

The mechanism is a discovery index at a well-known path. Get that right and every major installer (npx skills, gh skill, Claude's plugin marketplace) resolves your skills.

Workflow

Steps 1–5 build on each other. Steps 6–8 are independently shippable.

1. Author each skill in a Git repo

Lay each one out as skills/<name>/SKILL.md. A repo is a hard requirement rather than a convenience, because two install paths resolve directly from it: