skill-forge

Create production-grade skills for Claude Code, Grok, Cursor, and other AI coding agents — in seconds.

One command. Proper structure. Real patterns from people who ship lots of these.

npx @edwardjgriggs/skill-forge create my-new-detection --template detection

Extract to its own GitHub repo & publish (quick)

1. Copy this folder outside the ai-workspace.
2. rm -rf node_modules dist tmp-* out
3. Edit package.json (repository, name if desired).
4. npm install && npm run build && npm test
5. git init && git add . && git commit -m "init"
6. Push to GitHub.
7. npm publish --access public (required first time for scoped packages like @edwardjgriggs/skill-forge)

Users will then be able to npx @edwardjgriggs/skill-forge (or install globally) and also npx skills add https://github.com/you/my-awesome-skill for skills you generate with it.

Why this exists

The built-in interactive creators are fine for a quick start.

Real, shareable, high-leverage skills (see engineering-skills collections, playwright-pro, detection-engineering, OpenMontage, compliance tools, etc.) have a consistent rich shape:

• Crystal-clear description frontmatter that makes auto-triggering reliable
• Operating rules + explicit workflow
• references/ for deep reusable knowledge
• Scripts + examples + tests/golden outputs
• Safety notes and audience-aware output guidance

skill-forge bakes those patterns in so your skills look and behave like the ones people actually depend on.

Quick start

# Create a new skill
npx @edwardjgriggs/skill-forge create tenant-audit --template ops

cd tenant-audit

# Validate it
npx @edwardjgriggs/skill-forge validate .

# Install (Grok example)
cp -r . ~/.grok/skills/tenant-audit

Inside your agent:

/tenant-audit help me audit our Entra sign-in risk policy

Templates

• base — clean general purpose
• ops — M365, PowerShell, tenant automation, runbooks
• eng — code review, architecture, implementation, QA
• detection — KQL / Sigma / ATT&CK mapping, validation plans

More templates coming (creative pipelines, agent workflow meta, compliance, etc.).

What you get

my-skill/
├── SKILL.md           # Frontmatter + precise instructions
├── README.md          # How to install + use the skill
├── references/
│   └── patterns.md    # Your deep knowledge
└── scripts/
    └── example.py     # Helper automation (expand freely)

Install the CLI globally (optional)

npm install -g @edwardjgriggs/skill-forge

Windows notes

Works great under PowerShell and Windows Terminal. Paths are handled with node:path.

Recommended install for daily use:

npm install -g @edwardjgriggs/skill-forge

Or just keep using npx — zero friction.

Philosophy

• Description frontmatter is sacred (this is what makes the skill appear automatically).
• Favor copy-paste examples over vague prose.
• Make the safe path the easy path.
• Generated skills should be immediately useful and easy to improve.

Contributing / Creating better templates

PRs that add high-quality templates (with real references and example scripts) are extremely welcome.

See the skills in this author's workspace for inspiration:

• .agents/skills/detection-engineering
• .agents/skills/m365-tenant-ops
• .claude/skills/engineering-skills/*
• OpenMontage skills collection
• AIS-OS skills

How to extract & publish this tool itself

See the "Extract this to its own GitHub repo & publish" section above.

License

MIT

---

Built by someone who has written and maintained dozens of these skills. If it feels like it was extracted from real usage instead of generated in a vacuum — that's because it was.