skills/BuildPlugin/SKILL.md
Create, validate, and publish Claude Code plugins from forge modules. USE WHEN create plugin, validate plugin, publish plugin, marketplace, plugin.json, cowork plugin.
npx skillsauth add n4m3z/forge-core BuildPluginInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create, validate, and publish forge modules as Claude Code plugins. Covers plugin.json creation, marketplace registration, and Cowork deployment.
| Workflow | Trigger | Reference | | ------------- | ---------------------------------------------- | -------------------- | | Create | "create plugin", "add plugin.json" | Instructions below | | Validate | "validate plugin", "check marketplace readiness" | Instructions below | | Marketplace | "add to marketplace", "publish to cowork" | @ClaudeMarketplace |
module.yaml for name, version, description..claude-plugin/plugin.json:{
"name": "module-name",
"version": "0.1.0",
"description": "From module.yaml",
"author": {"name": "Author"},
"license": "EUPL-1.2",
"repository": "https://github.com/owner/repo",
"keywords": [],
"skills": ["../skills"]
}
"hooks": "./hooks/hooks.json" only if the module has hooks.Check these in order. Stop on first failure.
| Check | Pass criteria |
| ------------------- | ------------------------------------------------------------ |
| plugin.json exists | .claude-plugin/plugin.json present and valid JSON |
| name | Lowercase kebab-case (Cowork enforces strictly) |
| version | Valid semver, matches module.yaml |
| description | Non-empty string |
| author | Object with name field |
| license | SPDX identifier present |
| repository | URL string present |
| keywords | Non-empty array |
| README.md | Exists, not empty |
| LICENSE | Exists |
| INSTALL.md | Follows install.md standard (OBJECTIVE, DONE WHEN, TODO) |
| CLAUDE.md | Exists |
| Skills | Each has SKILL.md with name/description/version frontmatter |
| Skill YAML | Each has SKILL.yaml with sources field |
Report:
Section Status
──────────────────────────────
plugin.json PASS / FAIL
module.yaml PASS / FAIL
Documentation PASS / FAIL
Skills PASS / FAIL
──────────────────────────────
Verdict: READY / NOT READY
development
Reactive correction and root-cause fix. USE WHEN something went wrong, user is frustrated, demands a correction, says wtf, what the hell, why did you, that's wrong, this is broken, no not that, stop. Executes the immediate fix, then hunts the upstream artifact that caused it and creates a corrective change.
development
Decompose a research question into sub-queries, spawn parallel WebResearcher agents per angle, synthesize findings with citations and explicit confidence. USE WHEN the user asks to research, investigate, look online, look up, dig into, find sources, gather evidence, or survey what's known about a topic. Single-pass; for multi-round adversarial research use ResearchCouncil in forge-council.
tools
Author project documentation that future humans (and AI sessions) actually read. Covers TLDRs for tools, READMEs, runbooks, journals. USE WHEN write documentation, create tldr, tool one-pager, document a cli, write readme, runbook, journal entry, capture knowledge about a tool, distill a session into reusable notes.
development
Review your own staged changes via a code-review TUI before triggering a commit. USE WHEN about to commit, walking through your own staged diff, self-reviewing before approval, tuicr, revdiff, git diff cached.