@humanmade/skill-forge
v0.2.0
Published
Human Made agent skills, distributable to Claude Code (and, soon, Cursor and Copilot).
Keywords
Readme
@humanmade/skill-forge
Human Made's collection of agent skills for WordPress / Altis / VIP development, distributable to Claude Code today and (soon) Cursor and GitHub Copilot.
What's in the box
| Skill | What it does |
|---|---|
| block-scaffolding | Scaffold a Gutenberg block, pattern, or template part following HM/VIP conventions |
| dependency-triage | Triage a Dependabot, Renovate, or VIP plugin-update PR; classify risk; recommend merge / batch / escalate |
| release-ceremony | Cut a release or hotfix PR following Altis/HM gitflow or VIP preprod→production conventions |
| vip-bootstrap | Bootstrap a new WordPress VIP project — composer, CI, theme skeleton, PHPUnit, VIP-specific config |
| wp-cli-importer | Scaffold a WP-CLI command for content import / migration with dry-run, batching, idempotent upserts |
| mega-menu | Scaffold and configure a mega menu in an FSE theme using humanmade/hm-mega-menu-block |
Each skill is a markdown file with frontmatter that the agent loads on demand based on the user's intent.
Install
Personal install — copies skills into ~/.claude/skills/:
npm install -g @humanmade/skill-forge
# or one-off:
npx @humanmade/skill-forgeProject dev dependency — symlinks into <project>/.claude/skills/ so updates flow through node_modules:
npm install --save-dev @humanmade/skill-forgeOn first install the postinstall hook auto-detects which adapters apply to the project (e.g. .claude/ for Claude Code) and installs every skill for them, then writes a .hm-skills.json lockfile. Subsequent installs (and postinstall on version bumps) resync from the lockfile.
To customize which vendors or skills are installed, run npx hm-skills — that's the interactive flow. Re-running rewrites the lockfile.
CLI
hm-skills # interactive: pick vendors and skills
hm-skills --yes # non-interactive: install everything for the default vendorVendor support
- Claude Code — installs each skill as
.claude/skills/<name>/(symlink for project scope, copy for global). - Cursor — translates
SKILL.mdinto.cursor/rules/<name>.mdc; carries the description over and setsalwaysApply: falseso the rule is agent-requested by description. - GitHub Copilot — translates
SKILL.mdinto.github/instructions/<name>.instructions.mdwithapplyTo: "**". Project scope only; Copilot has no equivalent global instructions location.
License
GPL-2.0-or-later
