subagentskills

Catalog of Agent Skills used across the opensubagents stack.

Each skill is a directory containing SKILL.md plus optional references/, scripts/, and assets/ subdirectories. The catalog manifest lives at .claude-plugin/marketplace.json.

Skills

Skill	Status	Pairs with	Tags
ts-bootstrap	released	@opensubagents/ts-bootstrap-mcp	typescript, bootstrap, mcp-server, cloudflare-worker
structured-research-output	released	research-brief-xml	research, output-format, url-ledger, atomic-output
research-brief-xml	released	structured-research-output	research, xml-brief, prompt-engineering
reveal-and-restore-worker-token	planned	—	cloudflare, secrets, ops-pattern
html-effectiveness-builder	planned	—	html, rendering, reports
subagenttasks-validator	planned	@opensubagents/subagenttasks	validation, json-schema, tasks
graphql-erd-from-zod	planned	—	graphql, zod, erd, html
brief-author-canonical	planned	@opensubagents/subagentbriefs	docs, briefs, authoring

Install

Three ways to consume a skill from this catalog:

1. Drop a .skill zip into your host. Some skill authors publish prebuilt .skill artifacts in their source repo's release assets — e.g. ts-bootstrap.skill ships at opensubagents/ts-bootstrap-mcp/dist-skills/ts-bootstrap.skill. Download and install per your host's flow (claude.ai: Settings → Capabilities → Skills; Claude Code: extract into ~/.claude/skills/).

2. Clone a single skill directory:

curl -sSL https://github.com/opensubagents/subagentskills/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=2 -C ~/.claude/skills \
    subagentskills-main/skills/ts-bootstrap

3. Reference the marketplace manifest from your host (preferred for multi-skill installs). Point your host at:

https://raw.githubusercontent.com/opensubagents/subagentskills/main/.claude-plugin/marketplace.json

The host walks the skills[] array and resolves each source.path against this repo's HEAD.

Author a new skill

cp -r template skills/<your-skill>
$EDITOR skills/<your-skill>/SKILL.md

# validate locally (clones the official validator into /tmp)
git clone --depth 1 https://github.com/anthropics/skills /tmp/anthropics-skills
( cd /tmp/anthropics-skills/skill-creator && python3 -m scripts.quick_validate "$PWD/../../../skills/<your-skill>" )

# add a marketplace entry (status: "planned" while drafting, "released" once verified)
$EDITOR .claude-plugin/marketplace.json

# open a PR — CI re-runs validation

See CLAUDE.md for coding-agent guidance and spec/agent-skills-spec.md for the spec pointer.

Repo layout

.
├── .claude-plugin/
│   └── marketplace.json              # canonical catalog manifest
├── .github/workflows/
│   ├── validate-frontmatter.yml      # quick_validate every skill on every PR
│   └── validate-marketplace.yml      # cross-check manifest ↔ skills/ on disk
├── skills/
│   └── ts-bootstrap/                 # the one released skill (so far)
│       ├── SKILL.md
│       ├── references/
│       │   ├── workflows.md
│       │   ├── tool-schemas.md
│       │   └── troubleshooting.md
│       └── scripts/
│           ├── check.sh
│           └── install.sh
├── template/
│   └── SKILL.md                      # copy-paste starter for new skills
├── spec/
│   └── agent-skills-spec.md          # pointer to agentskills.io/specification
├── CLAUDE.md                         # agent guidance
├── README.md
└── LICENSE                           # MIT

Deferred for v0.1 (will be added when there's a real consumer)

• .cursor-plugin/ — mirror manifest for Cursor's plugin format
• .mcp.json — references to MCP servers any skill depends on
• evals/ — Neon-style per-skill test fixtures
• .github/workflows/bump-skill-shas.yml — nightly SHA pin updates via the gh-pr-mcp worker

Setup notes (initial commit)

The initial commit was pushed by an automated worker whose token did not include workflows: write scope. As a result, two CI files that the design calls for were not landed by the bootstrap commit and need to be added manually (one-time setup):

• .github/workflows/validate-frontmatter.yml
• .github/workflows/validate-marketplace.yml

Both YAMLs are provided in the chat session that bootstrapped this repo. Drop them in via the GitHub web UI (Add file → Create new file), or re-push from a local checkout once the workflow files are committed.

Until these two files exist, the catalog has no automated validation — marketplace.json and skill frontmatter can drift. Adding them is the first follow-up task.

Also: the two scripts/*.sh files inside skills/ts-bootstrap/ are mode 100644 (not 100755) because the Contents API used for this initial commit does not preserve executable bits. Either chmod +x them after clone, or land a follow-up commit via the Git Trees API that sets the right mode.

License

MIT — matches the sibling opensubagents repos.