claude-skill-bootstrap

claude-skill-bootstrap

Scaffold a new Claude Code skill in 30 seconds — correct directory, valid SKILL.md frontmatter, optional helper script.

bun add -g claude-skill-bootstrap
claude-skill new lint-prd
# → ~/.claude/skills/lint-prd/SKILL.md  + helper.sh

Why this exists

Every time you start a new skill you end up copying frontmatter from another one, forgetting a field, misnaming the directory, or shipping with Read, Write, Bash allowed when you only meant Read. This CLI removes all of that friction.

Usage

# user-scope (default) — installs into ~/.claude/skills/<slug>/
claude-skill new my-skill

# project-scope — installs into ./.claude/skills/<slug>/
claude-skill new my-skill --scope project

# without the helper.sh stub
claude-skill new my-skill --no-script

Generated layout:

~/.claude/skills/my-skill/
├── SKILL.md          # frontmatter + workflow template
└── helper.sh         # executable bash stub (optional)

What's in SKILL.md

Frontmatter:

---
name: my-skill
description: One-sentence description of what this skill does and when to use it.
trigger_keywords:
  - my-skill
allowed_tools:
  - Read
  - Write
  - Bash
---

Plus four sections you fill in: Purpose, When to use, When NOT to use, Workflow, Outputs. The "When NOT to use" section is the one most authors skip — it's also the one that prevents skill-collision in production.

Install

Requires Bun ≥ 1.0 or Node ≥ 18.

bun add -g claude-skill-bootstrap
# or per-project
bun add -d claude-skill-bootstrap

Local development

bun install
bun run build
bun test
bun run dev new test-skill --scope project

License

MIT © Ivan Mokan