技能工厂

Quick Install

```bash

Full pipeline — works in Claude Code, Copilot, Cursor, Codex, Gemini, Grok Build

/prd "add user authentication" # create requirements /forge # validate → implement → gate → audit → harvest /goma # autonomous mode: just describe what you want

One-time setup: connect a global knowledge repo

scripts/knowledge-sync.sh init https://github.com/you/dev-memory.git

Or build from source

cd skillfoundry-vscode && npm install && npm run build code --install-extension skillfoundry-1.3.0.vsix ```

IDE Skills (63 — Claude Code, Copilot, Cursor, Codex, Gemini, Grok Build)

These work inside your AI coding tool, not in the sf CLI:

Note: /forge exists in both systems but they are different implementations. The IDE skill orchestrates sub-agents; the CLI command runs a self-contained pipeline.

---

Quick Start (5 Minutes)

1. Install & Setup

npm install -g skillfoundry
sf setup                           # Pick provider, paste API key

2. Create a PRD

/prd "add user authentication"     # Describe your feature

3. Forge Production Code

/forge                             # Validate, implement, and test automatically

Using an IDE? Run npx skillfoundry init in your project to add these skills directly to Claude Code, Cursor, or Copilot.

<details> <summary><strong>Windows (PowerShell)</strong></summary>

```powershell

Option A: npx

cd C:\MyProject npx skillfoundry init

Option B: npm global

npm install -g skillfoundry cd C:\MyProject; skillfoundry init

Option C: git clone

git clone https://github.com/samibs/skillfoundry.git C:\DevTools\skillfoundry cd C:\MyProject C:\DevTools\skillfoundry\install.ps1 ```

</details>

Requires Node.js v20+ for the standalone CLI. IDE skills work without Node.js. Cross-platform: Works on Linux, macOS, Windows (native, Git Bash, and WSL). Quality gates and anvil scripts auto-detect the environment. New to SkillFoundry? See the Todo API example — a complete project built from a single PRD in two commands. For model recommendations, see Model Compatibility.

---

.skillfoundry/config.toml

[budget] monthly_limit_usd = 50.00 per_run_limit_usd = 2.00 ```

Token usage and cost are shown live in the header during streaming.

.skillfoundry/config.toml

[routing] route_local_first = true # Enable local-first routing local_provider = "ollama" # or "lmstudio" local_model = "llama3.1" # your preferred local model context_window = 0 # 0 = auto-detect from model

**What happens when enabled:**
- Simple tasks (docs, formatting, boilerplate) route to your local model (free)
- Complex tasks (architecture, security, refactoring) route to cloud (paid)
- Context compaction automatically fits prompts within local model limits (4K-32K)
- If the local model is offline, cloud fallback activates with a warning

Standalone CLI — no IDE needed

npm install -g skillfoundry sf setup # interactive: choose provider, paste API key sf forge # run the full pipeline from your terminal

2. The Standalone CLI (`sf`)

A separate terminal app with its own AI connection. Useful for provider switching, budget controls, and working outside an IDE. Has 23 native commands (not all 64 skills).

 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
 │ ◆ SkillFoundry CLI    anthropic:claude-sonnet ● team:dev ● $0.00 ● 14.2k tok │
 └──────────────────────────────────────────────────────────────────────────────────┘

 │ ▸ sf:coder> I'll help you add dark mode. Let me look at the existing
 │             dashboard code...
 │
 │   ▸ bash    npm test                ✓ 0.8s
 │   ◉ read    src/styles/theme.ts     ✓ 0.1s
 │   ◈ write   src/styles/dark.ts      ✓ 0.1s
 │
 │   ● routed:high ● 142 in / 387 out ● $0.0045

 ╭──────────────────────────────────────────────────────────────────────────────────╮
 │ ⟫ looks good, now review for accessibility issues                               │
 ╰──────────────────────────────────────────────────────────────────────────────────╯

 │ ▸ sf:review> I'll review the dark mode implementation for accessibility...

---

Command Reference

sf CLI Commands (23 native)

These work inside the sf terminal app:

Pipeline Resume

/forge tracks story completion and resumes where it left off. If a run is interrupted or partially fails, re-running /forge skips already-completed stories and implements only the remaining ones.

Implementing 2 stories (3 already done, skipped)

Stories are marked status: DONE in their .md files after successful completion, including passing micro-gates and fixer loops.

Search "SkillFoundry" in the Extensions panel, or:

code --install-extension skillfoundry.skillfoundry

Pipeline Details

                    ┌─────────────┐
                    │   /prd      │  Write requirements
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │   /go       │  Validate → generate stories → implement
                    └──────┬──────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
        ┌─────▼─────┐ ┌───▼───┐ ┌─────▼─────┐
        │ Architect  │ │ Coder │ │  Tester   │  Agent pipeline
        └─────┬─────┘ └───┬───┘ └─────┬─────┘
              │            │            │
              └────────────┼────────────┘
                           │
                    ┌──────▼──────┐
                    │ Micro-Gates │  MG1 security + MG2 standards
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  The Anvil  │  T1-T6 quality gates
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  /security  │  OWASP scan + credential check
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │   /gohm     │  Harvest lessons → memory_bank/
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │ knowledge   │  Sync to global repo (optional)
                    │    sync     │  Lessons available in all projects
                    └─────────────┘

/forge runs this entire pipeline in one command. It discovers PRDs, generates stories, implements each story with the agentic tool-use loop, runs micro-gates (MG1 security + MG2 standards per story, MG3 cross-story review), runs T1-T6 quality gates (with auto-fixer retries), persists run metadata, and automatically harvests knowledge entries (run summaries, errors, gate verdicts) to memory_bank/knowledge/*.jsonl. Use /forge --dry-run for a read-only scan.

---

VS Code Extension (v1.3.0)

SkillFoundry ships a native VS Code extension that works as a complete standalone shell — setup wizard, CLI check, quality gates, telemetry, and forge runs directly in your editor.

┌──────────┬──────────────────────────────┬───────────────┐
│ Explorer │ Editor                       │ SF Sidebar    │
│          │                              │               │
│          │  src/auth.ts                 │ ◆ Dashboard   │
│          │  ─────────────────           │  Pass Rate 94%│
│          │  1 │ import { hash }         │  Last Forge ✓ │
│          │  2 │ // TODO: add rate  ⚠    │  CVEs: 2 high │
│          │    │ ▸ Run T1 (Patterns)     │               │
│          │    │ ▸ Run T4 (Security)     │ ◆ Gate Status │
│          │                              │  T0-T7 results│
│          │                              │               │
│          │                              │ ◆ Forge       │
│          │                              │  Phase: SPECTER│
│          │                              │  Story: 5/8   │
├──────────┴──────────────────────────────┴───────────────┤
│ SF: 94% gates │ sf:coder │ $0.12               Output   │
└─────────────────────────────────────────────────────────┘

Features (v1.3.0): - Setup wizard (SkillFoundry: Setup) — On first open, prompts for provider and API key. Key stored in VS Code SecretStorage; never written to disk. Auto-detects missing install and offers setup. - sf CLI check — Detects whether sf is on PATH at activation. If missing, offers npm install -g skillfoundry via integrated terminal in one click. - Forge progress — withProgress notification stays open for the duration of the forge run, cancellable. ForgeMonitor sidebar tracks phases live via forge-state.json. - Sidebar dashboard — gate pass rate, security findings, telemetry trends, dependency CVEs - Inline diagnostics — gate findings appear as squiggly underlines (like ESLint) - CodeLens — "Run T3 (Tests)" above test files, "Run T1/T4" above source files - Command palette — 13 commands: setup, gate, forge, metrics, report, memory recall, PRD, hooks, benchmark - Status bar — gate pass rate with color coding, click to open metrics - File watcher — auto-refreshes dashboard when telemetry updates

```bash

From VS Code Marketplace (recommended)