{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-tools-skills-distribution",
  "slug": "tools-skills-distribution",
  "title": "Agent skills: authoring & distribution (skills CLI)",
  "summary": "Tool roles, alternatives, selection tradeoffs, and compatibility caveats.",
  "category": "Tools",
  "tags": [
    "tools",
    "skills-distribution"
  ],
  "sources": [
    {
      "label": "Tool comparison reference",
      "url": "https://dewy-sleet-n5zs.here.now/#skills-distribution"
    }
  ],
  "sourceUnits": [
    "resources/index.html#skills-distribution"
  ],
  "collection": "factory",
  "categoryId": "tools",
  "wordCount": 230,
  "url": "/topics/factory-tools-skills-distribution/",
  "markdownUrl": "/markdown/factory-tools-skills-distribution.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-tools-skills-distribution.json",
  "headings": [
    {
      "id": "agent-skills-authoring-distribution-skills-cli",
      "text": "Agent skills: authoring & distribution (skills CLI)",
      "level": 2
    },
    {
      "id": "pick-this-if",
      "text": "Pick this if…",
      "level": 3
    }
  ],
  "markdown": "# Agent skills: authoring & distribution (skills CLI)\n\nTool roles, alternatives, selection tradeoffs, and compatibility caveats.\n\n## Agent skills: authoring & distribution (skills CLI)\n\n**John uses:** the [skills CLI](https://github.com/vercel-labs/skills) (26.4k; `npx skills add <source> --skill <name>`, skills.sh) with canonical skills in `~/.agents/skills` symlinked into each agent's skill dir. Section 07 even publishes an installable skill on the workshop page itself.\n\n| Alternative | What it is | How it differs | License |\n|----|----|----|----|\n| [anthropics/skills](https://github.com/anthropics/skills) | Anthropic's public repository of Agent Skills | Official first-party skill collection to copy from rather than an installer CLI | none listed |\n| [superpowers](https://github.com/obra/superpowers) | An agentic skills framework and software-development methodology | Opinionated bundled methodology (brainstorm→plan→implement) vs à-la-carte skill installs | MIT |\n| [Claude Code plugins/marketplaces (built-in)](https://docs.claude.com/en/docs/claude-code) | Native plugin + marketplace system bundling skills, commands, hooks, MCP servers | First-party distribution channel; Claude-Code-only where skills.sh targets many agents | product |\n| [MCP servers](https://github.com/modelcontextprotocol) | Model Context Protocol: distribute agent capabilities as tool servers rather than markdown skills | Tools-as-processes vs instructions-as-markdown; complementary, heavier to build | open spec (MIT) |\n\n### Pick this if…\n\n- **anthropics/skills** — you want first-party, well-audited skills to copy from.\n- **superpowers** — you want a whole opinionated methodology, not à-la-carte installs.\n- **Claude Code plugins** — you're Claude-Code-only and want first-party distribution.\n- **MCP** — the capability needs real code/tools, not instructions."
}
