skill-forge
skill-forge is a Claude Code plugin marketplace for forging agent runtime environments. It distills reusable skills into plugins covering repository knowledge, code quality, commit discipline, autonomous fix loops, OpenCode configuration, and Codex subagent routing.
Core idea: Human at the helm. Agents execute. The repo is the agent's runtime — knowledge, rules, and workflows must be shaped into forms agents can reliably read, judge, and execute.
Keywords: claude-plugin, claude-code, agent-skills, agent-harness, openai-harness-engineering, opencode, code-review, clean-commit
Quick Start
# 1. Add the Skill Forge marketplace
claude plugin marketplace add gzb1128/skill-forge
# 2. Install the plugins you need
claude plugin install agent-docs@skill-forge
claude plugin install code-quality@skill-forge
claude plugin install skill-creator@skill-forge
claude plugin install opencode-customize@skill-forge
claude plugin install codex-strategy@skill-forge
claude plugin install github-contrib@skill-forge
# 3. In your target repo, ask your agent:
# "bootstrap agent docs" -> create a minimal AGENTS.md entry point
# "review my changes" -> quality review on local diff
# "commit this" -> gated commit with impact message
# "loopfix" -> autonomous review-fix loop
# "migrate this skill" -> adapt/create skills with eval discipline
# "hydrate model config" -> fill OpenCode custom model parameters
# "delegate this to subagents" -> route Codex implementation workers
# "find issues I can pick up" -> rank contribution-ready GitHub issues
Plugin versions are resolved to git commit SHA. Every push produces a new installable version — no manual semver maintenance. Run claude plugin update <plugin>@skill-forge (or wait for auto-update) to pull the latest.
Plugins
| Plugin | Purpose | Skills |
|---|---|---|
agent-docs | Bootstrap and maintain valuable repository knowledge with focused capture and audit workflows | bootstrap-agent-docs, learn, remember, curate |
code-quality | Turn code review, commit gates, diff cleanup, and fix loops into repeatable agent workflows | quality-reviewer, clean-commit, diff-cleanup, loopfix |
skill-creator | Create, migrate, evaluate, and tune skills for Skill Forge plugin workflows | skill-creator |
opencode-customize | Customize OpenCode configuration, including model metadata hydration and external project references | hydrate-opencode-models, integrate-projects |
codex-strategy | Route explicitly requested Codex implementation workers by design clarity and coupling while leaving other roles native | codex-subagent-strategy |
github-contrib | Find contribution-ready GitHub issues with claimed status, PR linkage, difficulty, staleness, maintainer engagement, and area signals | find-contributable-issues |
Skill Catalog
agent-docs
| Skill | Type | Purpose |
|---|---|---|
bootstrap-agent-docs | model-invoked | Create a minimal root AGENTS.md with verified commands and architecture routing |
learn | manual skill (/agent-docs:learn) | Score, route, and propose valuable session knowledge for AGENTS.md or docs/ — verified and approval-gated |
remember | manual skill (/agent-docs:remember) | Audit AGENTS.md knowledge for staleness, duplication, and misplacement |
curate | manual skill (/agent-docs:curate) | Audit the docs/ knowledge base for stale links, encyclopedia bloat, naming drift, and missing indexes — the docs counterpart to /agent-docs:remember |
The minimal AGENTS.md template used by bootstrap-agent-docs lives at plugins/agent-docs/templates/ and resolves at runtime via ${CLAUDE_PLUGIN_ROOT}/templates/. No separate repo clone is needed.
code-quality
| Skill | Type | Purpose |
|---|---|---|
quality-reviewer | model-invoked | Structured local review with one independent reviewer, integrated risk checks, and direct quality gates |
clean-commit | model-invoked | Run quality gates (via quality-reviewer) before committing, with messages that explain WHY |
diff-cleanup | model-invoked | Remove AI-generated bloat (slop comments, dead code, defensive noise, redundant logic) from a feature branch diff |
loopfix | model-invoked | Autonomous review-fix loop: reviewer subagent finds issues, main agent triages and fixes, repeat until clean |
skill-creator
| Skill | Type | Purpose |
|---|---|---|
skill-creator | model-invoked | Adapt upstream skills, create Skill Forge plugin skills, design RED/GREEN scenarios, run eval benchmarks, and tune trigger descriptions |
opencode-customize
| Skill | Type | Purpose |
|---|---|---|
hydrate-opencode-models | model-invoked | Look up model metadata from the Models.dev catalog and map it to OpenCode custom provider model config |
integrate-projects | model-invoked | Add external codebases to project-level OpenCode references so agents can discover and inspect them when relevant |
codex-strategy
| Skill | Type | Purpose |
|---|---|---|
codex-subagent-strategy | model-invoked | Before an explicitly requested Codex spawn, route high-coupling pre-design work to Sol/medium, bounded pre-design work to Luna/xhigh, and general coding to Terra/high |
Skill Forge keeps marketplace source in plugin layout. Compatible agent skill
installers expose installed skills through ~/.agents/skills/<skill>.
github-contrib
| Skill | Type | Purpose |
|---|---|---|
find-contributable-issues | model-invoked | Investigate open GitHub issues and rank which ones are worth picking up as a contributor |
What agent-docs Scaffolds
When you ask Claude to "bootstrap agent docs" in a target repo, the plugin creates one project entry point after showing the plan and receiving approval:
your-repo/
└── AGENTS.md # concise commands, architecture, routing, and project rules
It does not pre-create docs/ categories or copy plugin policy into the target
repository. /agent-docs:learn creates a category and its INDEX.md on demand
when the first admitted document needs that surface.
Practices
| Practice | Meaning |
|---|---|
| Repo as record system | Knowledge agents can't see doesn't exist. Critical constraints must not live only in chat logs or external docs. |
| Progressive disclosure | AGENTS.md provides the entry navigation, docs/codemaps/*.md points to components, source code carries the details. |
| Lean prompt surfaces | State prompt-resident rules once, expose only task-relevant tools, and keep examples only when they encode a requirement or fix a measured gap. Validate removals against the same representative tasks. |
| INDEX with the first doc | A category containing useful documents normally has an INDEX.md with routing context; absent categories need no placeholders. |
| Value-based admission | Non-derivable knowledge is automatically admitted; derivable knowledge is also recorded when impact, recurrence, discovery cost, actionability, durability, and scope justify the surface cost. |
| Maps, not encyclopedias | Codemaps maintain concept-to-path tables only — they link to source, never copy code. |
| Durable designs, transient task plans | YYYY-MM-DD-<topic>-design.md records lasting decisions and delivery boundaries; step-by-step agent plans stay in the task session. |
Full rationale: Repository Knowledge Lifecycle.
Development
This repo is both the marketplace catalog and the plugin source. See AGENTS.md for the development workflow, local verification commands, and SHA-based versioning policy.
Common commands:
make validate
make test-skills-link
make test-skills-status
make test-skills-unlink
License
This project is licensed under the MIT License.