skill-forge

Researches a topic and generates a portable SKILL.md skill file.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill skill-forge-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-forge
Source: https://github.com/bm629/agent-skills/tree/main/skills/skill-forge
Command: npx skills add https://github.com/bm629/agent-skills --skill skill-forge-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When an agent hits a knowledge gap on a library, framework, tool, or domain, it has no reusable instructions for that topic. skill-forge closes the gap by researching the topic and synthesizing a focused, portable SKILL.md that future sessions can load automatically. ## Core Features & Use Cases - Find-first research pipeline: Sweeps existing published skills as source material, runs deep web research, then fact-checks findings against cited sources before writing anything. - Triage with cache/improve/create modes: Detects whether a matching forge-made skill already exists, extends it in place when coverage is missing, or creates a new skill — never silently overwriting third-party skills. - Verified, self-contained output: Every generated skill passes a six-check verification gate and a multi-cycle adversarial self-review, ships with research provenance in references/sources.md, and is returned inline for same-turn use. - Use Case: You ask the agent to work with a library it does not know, such as uv. skill-forge researches uv's docs and pitfalls, then writes skills/uv/SKILL.md so the agent can use it immediately and in every future session. ## Quick Start Ask the agent to use skill-forge to research the FastAPI framework and create a reusable skill for it.

Frequently Asked Questions about skill-forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new AI agent skill for an unfamiliar library?

Invoke skill-forge with the topic name, optionally adding task context. It researches the library through existing published skills and web sources, fact-checks the findings, then writes a self-contained skills/<slug>/SKILL.md returned inline for immediate use.

How does skill-forge avoid duplicating an existing skill?

It triages the topic against local skills by their forge mark: full coverage returns the cached skill, partial coverage improves it in place, and third-party skills are returned as-is with an advisory. Name clashes on create abort with error F9 rather than overwriting.

Can skill-forge handle broad topics like a full tech stack?

Yes, through multi-skill fan-out. It detects breadth during triage, asks for task context, recommends a candidate list of focused skills, and forges each approved one via parallel worker subagents, at most five at a time.

Does skill-forge install skills it finds during research?

No. It follows a synthesize-only rule: found skills serve as source material and are paraphrased, never installed verbatim. If a strong existing skill is found, it recommends it and lets the caller perform the install.

What happens if web research returns inaccurate information?

A dedicated fact-check step dispatches a reviewer over the cited findings to flag unsupported, stale, or contradictory claims. Unsupported claims are dropped or repaired, and one targeted re-research round runs if coverage is thin.

When should I not use skill-forge?

Do not use it for project-specific topics that cannot be generalized, for vague topics without a concrete subject, or to forge skill-forge itself — the recursive-forge guard refuses self-replication with error F3.