create-skill-md

Scaffold a Claude Agent Skill in one command.

npx create-skill-md invoice-parser

What you get

invoice-parser/
├── SKILL.md        # frontmatter + a filled-in instruction skeleton
├── README.md
├── .gitignore
├── references/     # optional: deep context, API references
├── scripts/        # optional: python/bash helper scripts
├── assets/         # optional: static assets/schemas
└── evals/          # optional: test evaluation cases

Run it with no flags and it asks for a name, a description, and which optional folders you want. Pass flags and it stays quiet.

Options

| Flag | Description | | --- | --- | | -d, --description <text> | Frontmatter description (the trigger) | | -w, --with <list> | references,scripts,assets,evals | | -a, --all | Every optional folder | | -o, --out <dir> | Parent directory (default .) | | -y, --yes | No prompts, use defaults | | -f, --force | Write into a non-empty directory | | --dry-run | Preview files to be created without writing to disk | | -h, --help | Display usage and options | | -v, --version | Display version |

Examples

# Quick creation with defaults
npx create-skill-md invoice-parser -y -d "Extract line items from vendor invoices."

# Full bundle in custom location
npx create-skill-md research-notes --all --out ./skills

# Selective extras
npx create-skill-md csv-cleaner --with scripts,evals

# Dry-run preview
npx create-skill-md my-skill --dry-run

Installing a generated skill

Move the generated folder to wherever Claude Code looks for skills:

mv invoice-parser ~/.claude/skills/      # available everywhere
mv invoice-parser .claude/skills/        # available in this project only

For claude.ai or the API, zip the folder and upload it instead.

Local Development & Publishing

Test locally without publishing:

npm link
create-skill-md test-skill

Run the test suite:

npm test

Publish to npm:

npm publish --access public