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.
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.
- Analyzes your sources — extracts real function signatures, types, and patterns from code repositories, documentation websites, and developer discourse
- Compiles verified instruction files — every instruction links to the exact file and line it came from
- Follows an open standard — skills comply with the agentskills.io spec and work across Claude, Cursor, Copilot, and other AI agents
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.
Requires Node.js >= 22.
npx bmad-module-skill-forge installYou'll be prompted for project name, output folders, and IDE configuration. See the docs for other install methods.
- Set up your environment:
@Ferris SF— detects your tools and sets your capability tier - Generate your first skill:
@Ferris QS <package-name>— creates a verified skill in under a minute - Full quality path:
@Ferris BSthen@Ferris CS— brief first, then compile for maximum accuracy
See the workflows docs for all 12 available workflows.
- You use AI agents to write code and they keep getting API calls wrong — hallucinating function names, guessing parameter types, inventing methods that don't exist
- You maintain a library and want to ship official, verified instruction files so AI agents use your API correctly
- You manage a codebase with many dependencies and want a consolidated "stack skill" that teaches your agent how all the pieces fit together
- You use a SaaS API or closed-source tool with no public code — SKF can generate skills from documentation alone
- Getting Started — Installation, prerequisites, and your first skill
- Concepts — Plain-English definitions of all key terms
- How It Works — Architecture, capability tiers, output format, and design decisions
- Workflows — All 12 workflows with commands and connection diagrams
- Agents — Ferris: the AI agent that runs all SKF workflows
- Examples — Real-world scenarios, tips, and troubleshooting
SKF builds on these excellent open-source tools:
| Tool | Role in SKF |
|---|---|
| agentskills.io | Skill specification and ecosystem standard |
| GitHub CLI | Source code access and repository intelligence (all tiers) |
| ast-grep | AST-based structural code extraction (Forge/Forge+/Deep tiers) |
| ast-grep MCP | MCP server for memory-efficient AST queries (recommended) |
| cocoindex-code | Semantic code search and file discovery pre-ranking (Forge+ tier) |
| QMD | Local hybrid search engine for knowledge indexing (Deep tier) |
| skill-check | Skill validation, auto-fix, quality scoring, and security scanning |
| Snyk Agent Scan | Security scanning for prompt injection and data exposure (optional) |
| tessl | Content quality review, actionability scoring, and AI judge evaluation |
| BMad Method | Agent-workflow framework that SKF extends as a module |
See CONTRIBUTING.md for guidelines.
MIT License — see LICENSE for details.
Skill Forge (SKF) — A standalone BMad module for agent skill compilation.
See CONTRIBUTORS.md for contributor information.
