Extra Skills

Claude Code Agent Skills for the extra agent framework.

Two repositories, two jobs:

extra          = the main framework / runtime / CLI (agentctl, the engine, Docker image)
extra-skills   = Claude Code Agent Skills for setup, debugging, and onboarding

This repo does not contain the extra source — only skills, their reference docs and templates, a validation script, and CI.

Official documentation: https://extra-c586718a.mintlify.site/docs/introduction Go there for conceptual documentation (architecture, YAML reference, CLI, plugins). Use /extra-setup in Claude Code for hands-on project setup.

Install

List the skills in this repo:

npx skills add extra-org/extra-skills --list

Install all skills into the current project (for Claude Code):

npx skills add extra-org/extra-skills --skill '*' -a claude-code

Install all skills globally for Claude Code (available in every project):

npx skills add extra-org/extra-skills --skill '*' -a claude-code -g

• without -g → installs into the current project only.
• with -g → installs globally for Claude Code.

Usage

Open Claude Code in any project that uses (or will use) extra, then run:

/extra-setup
/extra-setup simple banking demo
/extra-setup repair my agents.yml
/extra-setup configure MCP tools and resolvers

What the skill does

/extra-setup turns Claude Code into a setup agent for extra. It:

1. Inspects the project (looks for agents.yml/agents.yaml, plugins/, prompts/, package manager, Docker, whether extra is installed).
2. Understands the goal from your argument, or infers a safe minimal demo.
3. Creates or repairs agents.yml — one root orchestrator plus focused agents — using a minimal, valid template, without destructive rewrites.
4. Configures agents, MCP servers (URL-based), tools, resolvers (with shared/agent scope), and access control (protected + plugins/access.py).
5. Discovers the real commands from the project (never guesses) and runs agentctl generate / agentctl validate (or their Docker equivalents), plus any tests/lint/typecheck the project defines.
6. Summarizes what it detected, created, changed, ran, and what to do next.

It ships with reference docs it reads on demand: extra-concepts, agents-yml-guide, and troubleshooting, plus a minimal agents.yml template.

Development

npm install      # no runtime deps; sets up npm scripts
npm run validate # validate every skill in skills/

npm run validate runs scripts/validate-skills.mjs (Node built-ins only), which checks that each skill has a SKILL.md with valid frontmatter, a name matching its folder, kebab-case naming, resolvable reference links, and no committed secrets or private paths. CI runs the same check on every push and pull request.

License

MIT © extra-org