skill-forge

Skill Forge (SKF)

Turn code and docs into instructions AI agents can actually follow.

Skill Forge analyzes your code repositories, documentation, and developer discourse to build verified instruction files for AI agents. Every instruction links back to where it came from — nothing is made up.

If SKF helps your agent stop hallucinating, give it a ⭐ — it helps others find this tool.

The Problem

You ask an AI agent to use a library. It invents function names that don't exist. It guesses parameter types. You paste documentation into the context — it still gets details wrong. You write instructions by hand — they go stale the moment the code changes.

This isn't an edge case. It's the default experience.

How Skill Forge Fixes This

1. Analyzes your sources — extracts real function signatures, types, and patterns from code repositories, documentation websites, and developer discourse
2. Compiles verified instruction files — every instruction links to the exact file and line it came from
3. Version-aware — skills are stored per-version, so updating to v2.0 doesn't break your v1.x skill. Compatible with skill.sh and npx skills
4. Manageable lifecycle — rename skills and drop deprecated versions without manual file surgery. Transactional safety for destructive operations.
5. Follows an open standard — skills comply with the agentskills.io spec and work across Claude, Cursor, Copilot, and other AI agents

Before vs After

Without SKF — your agent guesses:

import cognee

# Agent hallucinates: sync call, wrong parameter name, missing await
results = cognee.search("What does Cognee do?", mode="graph")

With SKF — your agent reads the verified skill:

import cognee

# Agent follows the skill instruction:
# `search(query_text: str, query_type: SearchType = GRAPH_COMPLETION) -> List[SearchResult]`
# [AST:cognee/api/v1/search/search.py:L26]
results = await cognee.search(
    query_text="What does Cognee do?",
    query_type=cognee.SearchType.GRAPH_COMPLETION
)

The skill told the agent the real function name, the real parameters, and that the call requires await — all traced to the exact source line. This is from a real generated skill.

Install

Requires Node.js >= 22.

npx bmad-module-skill-forge install

You'll be prompted for project name, output folders, and IDE configuration. See the docs for other install methods.

Quick Start

1. Set up your environment: @Ferris SF — detects your tools and sets your capability tier
2. Generate your first skill: @Ferris QS <package-name> — creates a verified skill in under a minute
3. Full quality path: @Ferris BS → clear session → @Ferris CS — brief first, then compile for maximum accuracy

Tip: Start a fresh conversation before each workflow. SKF workflows load significant context — clearing between them prevents interference.

See the workflows docs for all 14 available workflows.

Who Is This For?