Sandbox
@AgriciDaniel/skill-forge

Claude Code skill pack for creating skills

Skill Forge gives Claude Code a reusable system for making skills. It covers planning a skill’s structure, scaffolding the file tree, reviewing quality, evolving from feedback, converting to other agents, and packaging for release. The repo organizes this around a main orchestrator skill, supporting sub-skills, and agent definitions for specialized steps.

171 stars44 forksPythonUpdated 5mo ago
Who it's for

Builders who want Claude Code to design, build, and publish reusable skills.

What it delivers

You can turn a rough idea into a packaged Claude Code skill with planning, validation, and release steps.

What it does

Plan skill architecture

Analyzes a use case, picks a complexity tier, and designs a skill structure with sub-skills.

Build skill file trees

Scaffolds `SKILL.md`, sub-skills, scripts, references, and agent files.

Review skill quality

Audits a skill and gives it a 0-100 health score across six categories.

Evolve from feedback

Refines triggering, instructions, and structure based on review results.

Publish for distribution

Packages skills as `.skill` files and prepares install scripts for GitHub release.

Convert to other agents

Ports skills to Codex, Gemini CLI, Antigravity, and Cursor formats.

Run evals and benchmarks

Runs evaluation pipelines, grading, and variance-based benchmark checks.

How to get it

  1. 1Run
    git clone https://github.com/AgriciDaniel/skill-forge.git
    cd skill-forge
    bash install.sh
  2. 2Run
    bash install.sh --uninstall
  3. 3Create a simple skill
    /skill-forge build my-tool
  4. 4Design a complex skill ecosystem
    /skill-forge plan "DevOps toolkit for Docker and Kubernetes management"
  5. 5Review an existing skill
    /skill-forge review ~/.claude/skills/my-skill
  6. 6Convert a skill for other platforms
    /skill-forge convert ~/.claude/skills/my-skill

README

Skill Forge — Ultimate Claude Code Skill Creator

Skill Forge

Blog: Learn how to build Claude Code skills

Design, scaffold, build, review, evolve, and publish production-grade Claude Code skills following the Agent Skills open standard.

Features

  • Plan — Analyze use cases, select complexity tier (1-4), design architecture with sub-skill decomposition
  • Build — Scaffold complete skill file trees with SKILL.md, sub-skills, scripts, references, and agents
  • Review — Audit any skill with a 0-100 health score across 6 quality categories
  • Evolve — Fix triggering issues, improve instructions, refine architecture based on feedback
  • Publish — Package as .skill files, generate install scripts, prepare for GitHub distribution
  • Convert — Port skills to OpenAI Codex, Google Gemini CLI, Google Antigravity, and Cursor
  • Eval — Run evaluation pipelines with assertions, grading, and multi-agent execution
  • Benchmark — Measure performance with variance analysis, multiple trials, and threshold gating

Installation

Unix / macOS / WSL

git clone https://github.com/AgriciDaniel/skill-forge.git
cd skill-forge
bash install.sh

Uninstall

bash install.sh --uninstall

Usage

Commands

CommandDescription
/skill-forgeInteractive skill creation wizard
/skill-forge plan <domain>Architecture and design planning
/skill-forge build <name>Scaffold and build a skill
/skill-forge review <path>Audit an existing skill (0-100 score)
/skill-forge evolve <path>Improve a skill from feedback
/skill-forge publish <path>Package for distribution
/skill-forge eval <path>Run eval pipeline to test skill quality
/skill-forge benchmark <path>Benchmark skill with variance analysis
/skill-forge convert <path>Convert to Codex, Gemini, Antigravity, or Cursor

Examples

Create a simple skill:

/skill-forge build my-tool

Design a complex skill ecosystem:

/skill-forge plan "DevOps toolkit for Docker and Kubernetes management"

Review an existing skill:

/skill-forge review ~/.claude/skills/my-skill

Convert a skill for other platforms:

/skill-forge convert ~/.claude/skills/my-skill

Quick scaffold with the CLI script:

python skill-forge/scripts/init_skill.py devops-toolkit --tier 3 --sub docker,k8s,monitor

Skill Complexity Tiers

TierNameStructureBest For
1MinimalSingle SKILL.mdSimple workflows, document generation
2WorkflowSKILL.md + scriptsTasks needing deterministic validation
3Multi-SkillOrchestrator + sub-skillsComplex domains with multiple workflows
4EcosystemFull system with agentsEnterprise-grade parallel analysis

Architecture

skill-forge/                       # Main orchestrator (Tier 4)
  SKILL.md                         # Entry point and routing
  references/                      # On-demand knowledge (10 files)
  scripts/                         # Execution scripts (8 files)
  assets/templates/                # Skill templates (4 tiers)
skills/
  skill-forge-plan/                # Architecture planning
  skill-forge-build/               # Scaffolding and generation
  skill-forge-review/              # Quality auditing
  skill-forge-evolve/              # Improvement and iteration
  skill-forge-eval/                # Evaluation pipeline
  skill-forge-benchmark/           # Performance benchmarking
  skill-forge-publish/             # Distribution and packaging
  skill-forge-convert/             # Multi-platform conversion
agents/
  skill-forge-architect.md         # Architecture design agent
  skill-forge-writer.md            # Content writing agent
  skill-forge-validator.md         # Validation agent
  skill-forge-converter.md         # Platform conversion agent
  skill-forge-executor.md          # Eval execution agent
  skill-forge-grader.md            # Eval grading agent
  skill-forge-analyzer.md          # Benchmark analysis agent
  skill-forge-comparator.md        # Blind A/B comparison agent

Dependencies

  • Python 3.10+ — Required for scaffolding, validation, packaging, conversion, eval, and benchmarking scripts
  • Claude Code — The CLI tool these skills are built for
  • No external Python packages required (stdlib only)

Built With

Support

License

MIT


Author

Built by Agrici Daniel - AI Workflow Architect.

Files in the repo

Repository payload17 top-level entries
  • .claude-plugin
  • .github
  • agents
  • skill-forge
  • skills
  • .gitignore
  • CHANGELOG.md
  • CLAUDE.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • install.sh
  • LICENSE
  • README.md
  • SECURITY.md
  • skill-forge-header.jpeg
  • uninstall.ps1
  • uninstall.sh

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k