explaingit

jarvis823/skill-forge

★ 22PowerShellAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Shell and PowerShell tool that scans your repository in read-only mode and drives Claude Code to draft custom skills grounded in your own file paths and conventions.

Mindmap

mindmap
  root((skill-forge))
    Inputs
      Your repository
      Tier choice
    Outputs
      Recon files
      Draft skills
      Approved skills
    Use Cases
      Generate team skills
      Audit repo conventions
      Replace generic skill lists
    Tech Stack
      Shell
      PowerShell
      Claude Code

Things people build with this

USE CASE 1

Generate Claude Code skills that match your actual repo structure

USE CASE 2

Run a read-only recon of your codebase into .claude/forge-recon/

USE CASE 3

Vendor the tool under tools/skill-forge for team-shared skill drafting

USE CASE 4

Promote drafted skills to committed skills with per-skill approval

Tech stack

PowerShellBashShellClaudeCode

Getting it running

Difficulty · easy Time to first run · 30min

Needs Claude Code installed and either Bash or PowerShell, plus a decision between vendored versus standalone install.

Apache 2.0, a permissive license that lets you use, modify, and distribute the code commercially as long as you preserve copyright and license notices.

In plain English

Skill Forge is a small tool that helps teams create custom skills for Claude Code, the official Claude command line tool. A skill is a packaged set of instructions that Claude loads when you work in a particular kind of repo. The README opens with a complaint about the usual way people get skills: someone posts a list of top ten skills on Reddit, you paste them into your repo, and they end up giving advice that fits the author's toy React project rather than your actual codebase. Skill Forge takes the opposite approach. Instead of pulling rules from the internet, Skill Forge runs a script that reads your own repository in read-only mode and writes five short plain text files to a folder called .claude/forge-recon/. These files describe the directory tree, the languages used, the package manifests, the entry points, and the tests. You then open Claude Code, load a system prompt that ships with Skill Forge, and pick a tier of one, two, or three. Claude drafts skills that quote real file paths and line numbers from your own code, so the advice matches the conventions your team already uses. You then approve each skill with y or N before anything is committed. The project includes two scripts. forge.sh runs on Linux, macOS, and Git Bash. forge.ps1 runs natively on Windows PowerShell. There is a templates folder with a skill template and a tracking manifest, and a prompts folder with the Claude system prompt. The README also explains two installation patterns: vendoring the tool inside your project under tools/skill-forge, which the author recommends for teams, or cloning it standalone for solo developers and pointing at the project with a --repo flag. The release notes for version 0.2.0, dated May 2026, describe a spec compliance pass against the official Claude Code Skills documentation. The script now enforces the skill name regex, caps description fields at 1536 characters, moves the tracking manifest out of the skills directory so Claude does not mis-parse it, and adds an optional when_to_use field to the skill template. A migration guide is provided for upgrading from 0.1.x. The project is licensed under Apache 2.0. The README is structured around a clear table of contents covering installation, per-OS usage, sample recon output, the forge workflow, the draft to skill promotion flow, and troubleshooting.

Copy-paste prompts

Prompt 1
Run forge.sh against my current repo and show me what lands in .claude/forge-recon/
Prompt 2
Draft a tier 2 set of skills using skill-forge for this Python and React codebase
Prompt 3
Migrate my skill-forge 0.1.x skills to the 0.2.0 spec, including the when_to_use field
Prompt 4
Set up skill-forge as a vendored tool under tools/skill-forge for my team
Prompt 5
Use the PowerShell version forge.ps1 to generate skills for my Windows .NET project
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.