skill-creator

Give an AI agent a link to an OpenAPI spec, GraphQL schema, or MCP server and get back a ready-to-use Agent Skill with wrapper scripts, references, and usage notes.

Instead of pasting API docs into every chat, install one slash command and let your agent create reusable command-line skills for the tools your team uses.

Install

Requires Node.js ^22.22.2 || ^24.15.0 || >=26.0.0 (Node 26 is used in CI).

Install the /skill-creator command and companion improvement skill with npx:

npx @asnd/skill-creator command install --agent pi --scope global

This installs:

~/.pi/agent/prompts/skill-creator.md
~/.pi/agent/skills/skill-creator-improvement/

For a project-local command and improvement skill:

npx @asnd/skill-creator command install --agent pi --scope project

Skip the companion skill if you only want the prompt command:

npx @asnd/skill-creator command install --agent pi --scope global --no-improvement-skill

Other supported agents include claude-code, codex, cursor, opencode, gemini-cli, github-copilot, cline, and windsurf.

npx @asnd/skill-creator command install --agent claude-code --scope project

Use it

Open your agent and run /skill-creator with the source you want to turn into a skill.

/skill-creator https://example.com/openapi.json

That is the normal flow: provide the spec/server/schema link, answer any missing install questions, and the agent creates the skill for you.

More examples:

/skill-creator --spec https://example.com/openapi.json --name youtube --agent pi --scope project
/skill-creator --graphql https://api.example.com/graphql --graphql-schema https://example.com/schema.graphql --name pokeapi
/skill-creator --mcp https://mcp.example.com/mcp --name context7
/skill-creator --mcp-stdio "npx -y @example/mcp-server" --name example-mcp

What it creates

A generated skill looks like this:

.pi/skills/youtube/
├── SKILL.md
├── scripts/
│   └── youtube
└── references/
    └── openapi-spec-MM-DD-YYYY.json

Future agents can then use simple commands instead of reading API docs from scratch:

./scripts/youtube commands list
./scripts/youtube commands search videos
./scripts/youtube commands help <command>
./scripts/youtube run --pretty <command> <flags>

Generated scripts use npx -y @asnd/skill-creator internally, so consumers do not need a global install.

Skill improvement loop

Generated skills are tracked in ~/.skill-creator/lock.json. The companion skill-creator-improvement skill helps agents improve generated skills during real use. When the agent discovers a reusable gotcha, custom field, corrected command pattern, or faster workflow, it updates the generated skill's ## Gotchas section directly.

The improvement skill only works on skills tracked in the lock file, so it avoids touching skills that were not generated by skill-creator. Its description is refreshed after generation to include every tracked generated skill name, making the agent more likely to activate it after using those skills.

flowchart TD
    A[User runs<br/>npx @asnd/skill-creator command install] --> B[Install /skill-creator prompt command]
    A --> C[Install skill-creator-improvement skill]
    B --> D[User invokes /skill-creator with API/MCP/GraphQL source]
    D --> E[Agent researches source]
    E --> F[Agent runs<br/>skill-creator generate]
    F --> G[Generated skill files]
    F --> H[Write/Update ~/.skill-creator/lock.json entry]
    G --> I[Agent refines SKILL.md]
    I --> J[Agent smoke tests wrapper]
    J --> K[Final generated skill]
    K --> L[Future agent uses generated skill]
    L --> M{Reusable learning found?}
    M -- No --> L
    M -- Yes --> N[Invoke skill-creator-improvement]
    N --> O[Check lock.json<br/>Was this skill generated by skill-creator?]
    O -- No --> P[Do not modify skill]
    O -- Y

... [View full README on GitHub](https://github.com/sandiiarov/skill-creator#readme)