Skill Forge

FreeNot checked

An MCP server that exposes the Agent Skill creation guide (9 phases) as MCP resources, enabling AI agents to build SKILL.md files on demand.

by popyson1648

GitHub Embed

About

An MCP server that exposes the Agent Skill creation guide (9 phases) as MCP resources, enabling AI agents to build SKILL.md files on demand.

README

日本語

An MCP server that exposes the Agent Skill creation guide (9 phases) as MCP resources. AI agents retrieve only the phases they need on demand and follow the process to build SKILL.md files.

Quick Start

Claude Code:

claude mcp add skill-forge-mcp -- npx skill-forge-mcp

Gemini CLI:

gemini mcp add skill-forge-mcp -- npx skill-forge-mcp

VS Code (GitHub Copilot) — .vscode/mcp.json:

{
  "servers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"]
    }
  }
}

Cursor:

{
  "skill-forge-mcp": {
    "command": "npx",
    "args": ["skill-forge-mcp"]
  }
}

Claude Desktop

{
  "mcpServers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"]
    }
  }
}

Usage

Ask your agent:

"I want to create a skill for React component design. Follow the SkillForge MCP process."

The agent will automatically:

Fetch the process structure from process://manifest
Read Phase 1 (process://phase/1) for scoping, run baseline measurements
Record progress with mark_progress as it advances through each phase
Generate the final SKILL.md following Phase 6 guidelines

Use search_process for keyword lookups across phases.

The 9 Phases

Phase	Name	Purpose
0	Skill Specification	SKILL.md structure and frontmatter
1	Scoping & Baseline	Measure failure patterns; define research scope
2	Domain Research	Establish quality criteria and theoretical foundations
3	Gap Analysis	Verify whether research alone enables the agent to act
4	Deep Implementation Research	Fill gaps with code examples, anti-patterns, validation
5	Structuring & Completeness	Confirm coverage across all categories
6	Distillation into SKILL.md	Condense into ≤500 lines; maximize token efficiency
7	Deploy & Validate	Place, verify spec compliance, security review
8	Evaluate & Iterate	Compare against baseline, improve iteratively

Features

Staged access — retrieve content at phase or section granularity
Cross-phase search — keyword search across all 9 phases
Progress tracking — record and query per-phase completion status
Prompt templates — create_skill and resume_skill prompts for guided workflows
Structured output — outputSchema + structuredContent on all tools for programmatic consumption
State persistence — optionally retain progress across sessions
Low overhead — ~1,500 token fixed cost to the context window

API

Resources

URI	Description
`process://manifest`	Full index (JSON)
`process://phase/0` – `process://phase/8`	Phase 0–8 content

Resource Templates

Template	Description
`process://phase/{phaseId}/section/{sectionName}`	Retrieve a single section
`process://phases/{+phaseIds}`	Batch retrieval (e.g. `1,2,3`)

Tools

Tool	Description	Input
`search_process`	Keyword search across all phases	`{ "query": "frontmatter", "maxResults": 5 }`
`mark_progress`	Record phase progress	`{ "phaseId": 1, "status": "in-progress" }`
`get_status`	Progress summary for all phases	`{}`

status: "not-started" · "in-progress" · "completed"

Prompts

Prompt	Description
`create_skill`	Full guided workflow (Phase 0→8). Accepts a `topic` argument.
`resume_skill`	Resume from current progress. Checks `get_status` and continues.

Configuration

Set SKILL_FORGE_PERSIST=true to persist progress to ~/.skill-forge-mcp/state.json:

{
  "mcpServers": {
    "skill-forge-mcp": {
      "command": "npx",
      "args": ["skill-forge-mcp"],
      "env": { "SKILL_FORGE_PERSIST": "true" }
    }
  }
}

Development

git clone https://github.com/popyson1648/skill-forge-mcp.git
cd skill-forge-mcp
npm install
npm run build
npm test          # 52 tests

Project structure

src/
├── index.ts        # Entry point
├── content.ts      # Content loading & section extraction
├── search.ts       # Cross-phase search
├── state.ts        # State management & persistence
├── status.ts       # Status table formatter
├── content/        # English content (served)
└── content-ja/     # Japanese translations (developer reference only)
tests/
├── content.test.ts
├── search.test.ts
├── state.test.ts
├── resources.test.ts
└── tools.test.ts

Requirements: Node.js >= 18

Contributing

Contributions are welcome! Feel free to open an Issue or submit a Pull Request.

License

MIT

from github.com/popyson1648/skill-forge-mcp

Install Skill Forge in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install skill-forge-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add skill-forge-mcp -- npx -y skill-forge-mcp

FAQ

Is Skill Forge MCP free?

Yes, Skill Forge MCP is free — one-click install via Unyly at no cost.

Does Skill Forge need an API key?

No, Skill Forge runs without API keys or environment variables.

Is Skill Forge hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Skill Forge in Claude Desktop, Claude Code or Cursor?

Open Skill Forge on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.