skill

skill-forge

Carefully crafted Agent Skills for Claude Code, Codex, Cursor, and SKILL.md-compatible agents.

bhoon716/skill-forgecommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/bhoon716/skill-forge itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 21, 2026

skill-forge

skill-forge packages focused workflows as portable SKILL.md bundles and installs the correct localized files into Codex, Gemini, Claude Code, Cursor, and GitHub Copilot projects. Each skill can include references, examples, evals, scripts, and agent metadata while keeping its core instructions focused.

Why skill-forge

One source, multiple agents: install the same skill into each agent's project-local skill directory.
Built-in localization: maintain English, Korean, and Simplified Chinese variants alongside one another.
Evidence-backed workflows: ship validation guidance, deterministic evals, and reusable examples with the skill.
Reviewable distribution: preview every installation with --dry-run before copying files.
Simple package model: a skill remains an ordinary directory centered on SKILL.md.

Quick start

Run directly with npx:

# List available skills
npx @bhoon716/skill-forge list --lang en

# Install one skill for Codex or Gemini
npx @bhoon716/skill-forge install bugfix --lang en --agent codex

# Install every skill in Korean to all supported local agent directories
npx @bhoon716/skill-forge install all --lang ko

Or install the CLI globally:

npm install -g @bhoon716/skill-forge
skill-forge

Running skill-forge without arguments opens the interactive installer.

Included skills

Skill	What it does
`architecture`	Compares architecture alternatives, records tradeoffs, and produces ADRs, reviews, system views, and migration plans.
`bugfix`	Reproduces or establishes evidence for broken behavior, identifies the root cause, applies the smallest safe fix, and chooses proportionate verification.
`cognitive-debt`	Audits codebase-wide comprehension risks such as duplicated rules, hidden coupling, unclear intent, and unnecessary indirection; ranks evidence-backed next steps.
`deep-code-review`	Coordinates independent review lenses, verifies candidate findings, removes root-cause duplicates, and reports confirmed issues.
`feature-dev`	Implements new behavior through a strict Red → Green → Refactor workflow.
`performance-testing`	Measures baseline and candidate performance under controlled conditions, investigates regressions and tradeoffs, and records evidence-backed conclusions.
`refactoring`	Improves internal structure through Baseline → Transform → Same Tests while preserving observable behavior.
`ultra-grill-me`	Pressure-tests plans, designs, strategies, research questions, and decisions through one-question-at-a-time Socratic interrogation.

Installation targets

`--agent`	Destination
`codex`, `gemini`	`./.agents/skills`
`claude`	`./.claude/skills`
`cursor`	`./.cursor/skills`
`copilot`	`./.copilot/skills`
`global`	All destinations above

Supported language codes are en, ko, and zh. English is the default. Use --dry-run to inspect source-to-destination mappings without changing files.

skill-forge install architecture --lang zh --agent claude --dry-run

Repository layout

skill-forge/
├── bin/                     # Installer CLI
├── docs/                    # Authoring, compatibility, naming, and testing guides
│   └── assets/              # Documentation and branding assets
├── skills/                  # Published multilingual skill packages
│   └── <skill-name>/
│       ├── SKILL.md         # English default
│       ├── SKILL.ko.md      # Korean
│       ├── SKILL.zh.md      # Simplified Chinese
│       ├── README*.md       # Human-facing documentation
│       └── references/      # Optional supporting material
├── templates/               # Starting points for new skills
└── tests/                   # CLI smoke tests

Some skills also include agents/, examples/, evals/, logs/, or scripts/ when the workflow requires them.

Authoring a skill

Define one narrow, repeatable job and its trigger boundary.
Put routing criteria in the frontmatter description.
Keep SKILL.md focused on non-obvious procedure and decision rules.
Move detailed material into references/ and reusable validation cases into examples/ or evals/.
Keep localized suffix pairs intact so the installer can map them correctly.
Validate the skill and run the repository tests before publishing.

See the authoring guide, naming rules, compatibility guide, and testing guide.

Validation

# Verify CLI behavior
npm test

# Preview a complete localized installation
node bin/cli.js install all --lang en --agent codex --dry-run

# Run the bundled Ultra Grill evaluator
python3 skills/ultra-grill-me/evals/check_evals.py --run-mock

License

MIT