feat: Skill Forge Studio integration (v0.5.0)

New features:
- Skill Forge Studio: 8-step guided SKILL.md creation wizard
  - Online mode via FastAPI backend + offline template fallback
  - AI provider bridge (reuses extension AI settings)
  - Auto-start/stop server lifecycle management
- OS workspace initialization (initOS) and system status commands
- 30 total commands (was 26): +2 Skill Forge, +2 OS commands

Quality & publishing:
- Add marketplace badges to package.json
- Update README with Skill Forge section and settings
- Update ROADMAP: 0.5.0 shipped, next is 0.6.x
- Update SECURITY.md: 0.5.x supported
- Fix CI/CD workflows: actions@v6 -> actions@v4 (v6 does not exist)
- Clean .vscodeignore dead entries

New modules: src/skillForge/ (7 files), src/commands/skillForge.ts,
src/commands/osWorkspace.ts

All checks pass: compile 0 errors, lint 0 warnings, 21/21 tests.
VSIX: 1018 KB, 91 files - no source leaks.

Author: Ronald Nyami

.github/workflows/ci.yml

@@ -26,10 +26,10 @@ jobs:
             node: "22"
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
 
       - name: Setup Node ${{ matrix.node }}
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node }}
           cache: "npm"
@@ -51,7 +51,7 @@ jobs:
 
       - name: Upload VSIX artifact
         if: matrix.os == 'ubuntu-latest' && matrix.node == '22'
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v4
         with:
           name: clawdcontext-vsix
           path: "*.vsix"

.github/workflows/release.yml

@@ -18,10 +18,10 @@ jobs:
       OVSX_PAT: ${{ secrets.OVSX_PAT }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v4
 
       - name: Setup Node
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v4
         with:
           node-version: "22"
           cache: "npm"

.vscodeignore

@@ -18,12 +18,9 @@ tsconfig.json
 
 CONTRIBUTING.md
 CODE_OF_CONDUCT.md
-GITHUB_SETUP.md
-PUBLISHING.md
 ROADMAP.md
 SECURITY.md
 SUPPORT.md
-MARKETPLACE_READINESS.md
 
 !dist/**
 !media/**

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [0.5.0] — 2026-03-14
+
+### Added
+- **Skill Forge Studio integration** — Create production-quality SKILL.md bundles directly from VS Code
+  - `ClawdContext: Create Skill with Skill Forge` — 8-step wizard (Elicitate → Architect → Generate → Validate → Iterate → Export)
+  - `ClawdContext: Toggle Skill Forge Server` — Start/stop the SFS Python backend from the status bar
+  - **Online mode**: Full SFS backend integration (recommend, generate, validate, export via REST API)
+  - **Offline mode**: Template-based generation for all 7 archetypes when backend is unavailable
+  - **AI bridge**: Forwards extension AI settings (OpenAI, Anthropic, Azure, DeepSeek, Ollama) to SFS backend
+  - **Auto-start**: Optional background start of SFS Python backend (`skillForge.autoStart` setting)
+  - **File output**: Writes generated skills directly to `.clawdcontext/skills/` in the workspace
+
+### New Settings
+- `clawdcontext.skillForge.serverUrl` — SFS backend URL (default: `http://localhost:8742`)
+- `clawdcontext.skillForge.apiKey` — API key for authenticated SFS backends
+- `clawdcontext.skillForge.autoStart` — Auto-start SFS backend on extension activation
+
+### Architecture
+- 7 new source files in `src/skillForge/`: sfsClient, serverManager, aiBridge, webviewHtml, skillForgePanel, templates, index
+- Zero new npm dependencies (HTTP client uses Node.js built-in `http`/`https`)
+- Vanilla HTML/CSS/JS webview (no bundler, no React)
+
 ## [0.4.1] — 2026-02-26
 
 ### Fixed

README.md

@@ -18,7 +18,7 @@ ClawdContext is a VS Code extension that treats your agent markdown files as an
   </a>
 </p>
 
-<!-- TODO: Replace with a 15-25s GIF: Analyze Workspace → diagnostics → Quick Fix → CER dashboard update -->
+<!-- Demo: Analyze Workspace → diagnostics → Quick Fix → CER dashboard update -->
 <p align="center">
   <img src="media/demo.png" alt="ClawdContext — CER dashboard and context health overview" width="640" />
 </p>
@@ -40,6 +40,15 @@ ClawdContext is a VS Code extension that treats your agent markdown files as an
 - Explain diagnostics, detect semantic contradictions, validate agent files, suggest refactors, deep security review
 - Works with OpenAI-compatible, Anthropic-compatible, Azure OpenAI, Ollama (local), and DeepSeek-compatible providers
 
+### Skill Forge Studio (new in 0.5.0)
+
+- **8-step guided wizard** to create production-quality SKILL.md files from scratch
+- **6 domains** (DevOps, Security, Data, Frontend, Backend, AI/ML) × **7 archetypes** (Automator, Guardian, Analyst, Builder, Optimizer, Integrator, Specialist)
+- **Online mode** — connects to the Skill Forge Studio FastAPI backend for AI-powered generation with quality scoring
+- **Offline mode** — built-in templates work without any backend, no network required
+- **AI bridge** — automatically reuses your extension AI provider settings for the backend
+- **Server lifecycle** — auto-start/stop the Python backend from within VS Code
+
 ---
 
 ## The model: what goes where
@@ -91,7 +100,7 @@ Each diagnostic comes with a **quick-fix code action** when applicable.
 | **Prune Stale Lessons** | Archive lessons past TTL |
 | **Archive Deprecated Entries** | Clean dead rules |
 
-15 core commands + 11 AI commands — 26 total. [Full command list →](https://github.com/yaamwebsolutions/clawdcontext4vscode#commands)
+15 core commands + 11 AI commands + 4 OS/Skill Forge commands — 30 total. [Full command list →](https://github.com/yaamwebsolutions/clawdcontext4vscode#best-commands-the-8-youll-use-daily)
 
 ---
 
@@ -127,7 +136,15 @@ No telemetry. No analytics. No tracking.
 | `clawdcontext.lessonsTtlDays` | `60` | Days before a lesson is stale |
 | `clawdcontext.lessonsMaxEntries` | `50` | Max lessons before Kessler risk |
 
-All settings: [full configuration reference →](https://github.com/yaamwebsolutions/clawdcontext4vscode#configuration)
+**Skill Forge** (new in 0.5.0):
+
+| Setting | Default | What it controls |
+|---|---|---|
+| `clawdcontext.skillForge.serverUrl` | `http://localhost:8742` | Skill Forge Studio backend URL |
+| `clawdcontext.skillForge.apiKey` | *(empty)* | API key for the backend (if protected) |
+| `clawdcontext.skillForge.autoStart` | `false` | Auto-start the Python backend on activation |
+
+All settings: [full configuration reference →](https://github.com/yaamwebsolutions/clawdcontext4vscode#minimal-settings-start-here)
 
 ---
 

ROADMAP.md

@@ -28,7 +28,15 @@ ClawdContext is already useful in production workflows, but the goal is a catego
 - [ ] BPE-backed tokenizer (replace character-ratio estimation with cl100k_base-calibrated counts)
 - [ ] Positional heatmap improvements — drag-to-reorder suggestions
 
-## Next (0.5.x)
+## Shipped (0.5.0)
+
+- [x] **Skill Forge Studio** — AI-powered SKILL.md creation wizard with 8-step guided flow
+- [x] Online mode (FastAPI backend) + offline fallback (built-in templates)
+- [x] AI provider bridge — reuses extension AI settings for the Skill Forge backend
+- [x] Auto-start / auto-stop server lifecycle management
+- [x] OS workspace initialization (`initOS`) and system status commands
+
+## Next (0.6.x)
 
 - Rule suppression / waiver UX with inline `<!-- clawdcontext-ignore -->` and audit trail
 - Performance tuning for large monorepos (incremental analysis, file-change debouncing)

SECURITY.md

@@ -4,6 +4,7 @@
 
 | Version | Supported |
 |---|---|
+| `0.5.x` | Yes |
 | `0.4.x` | Yes |
 | `< 0.4.0` | No |
 

package.json

@@ -2,7 +2,7 @@
   "name": "clawdcontext",
   "displayName": "ClawdContext — Markdown OS for AI Agents",
   "description": "VS Code extension for AI coding agent Markdown systems: CER dashboard, mdcc-style diagnostics, lessons governance, SKILL.md security scanning, and quick-fix refactors.",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "publisher": "clawdcontext",
   "author": {
     "name": "Claudisiar"
@@ -18,6 +18,23 @@
   },
   "qna": "https://github.com/yaamwebsolutions/clawdcontext4vscode/discussions",
   "pricing": "Free",
+  "badges": [
+    {
+      "url": "https://img.shields.io/github/actions/workflow/status/yaamwebsolutions/clawdcontext4vscode/ci.yml?branch=main&label=CI&logo=github",
+      "href": "https://github.com/yaamwebsolutions/clawdcontext4vscode/actions/workflows/ci.yml",
+      "description": "CI status"
+    },
+    {
+      "url": "https://img.shields.io/github/license/yaamwebsolutions/clawdcontext4vscode?color=blue",
+      "href": "https://github.com/yaamwebsolutions/clawdcontext4vscode/blob/main/LICENSE",
+      "description": "License: MIT"
+    },
+    {
+      "url": "https://img.shields.io/github/stars/yaamwebsolutions/clawdcontext4vscode?style=social",
+      "href": "https://github.com/yaamwebsolutions/clawdcontext4vscode",
+      "description": "GitHub Stars"
+    }
+  ],
   "engines": {
     "vscode": "^1.96.0"
   },
@@ -203,6 +220,26 @@
         "command": "clawdcontext.aiContradictions",
         "title": "ClawdContext AI: Detect Contradictions",
         "icon": "$(warning)"
+      },
+      {
+        "command": "clawdcontext.initOS",
+        "title": "ClawdContext: Initialize OS Workspace",
+        "icon": "$(rocket)"
+      },
+      {
+        "command": "clawdcontext.osStatus",
+        "title": "ClawdContext: OS System Status",
+        "icon": "$(shield)"
+      },
+      {
+        "command": "clawdcontext.skillForge",
+        "title": "ClawdContext: Create Skill with Skill Forge",
+        "icon": "$(symbol-constructor)"
+      },
+      {
+        "command": "clawdcontext.skillForgeToggleServer",
+        "title": "ClawdContext: Toggle Skill Forge Server",
+        "icon": "$(server-process)"
       }
     ],
     "viewsContainers": {
@@ -409,6 +446,16 @@
           "command": "clawdcontext.scaffoldMarkdownOS",
           "when": "view == clawdcontext.layers",
           "group": "overflow@5"
+        },
+        {
+          "command": "clawdcontext.initOS",
+          "when": "view == clawdcontext.layers",
+          "group": "overflow@6"
+        },
+        {
+          "command": "clawdcontext.osStatus",
+          "when": "view == clawdcontext.layers",
+          "group": "overflow@7"
         }
       ],
       "view/item/context": [
@@ -638,6 +685,23 @@
           "type": "string",
           "default": "",
           "description": "Passphrase for the PFX/P12 certificate. Only needed if your PFX file is password-protected."
+        },
+        "clawdcontext.skillForge.serverUrl": {
+          "type": "string",
+          "default": "http://localhost:8742",
+          "description": "Skill Forge Studio backend URL.",
+          "markdownDescription": "URL of the Skill Forge Studio backend.\n\nDefault: `http://localhost:8742`\n\nChange this if you run the backend on a different host or port."
+        },
+        "clawdcontext.skillForge.apiKey": {
+          "type": "string",
+          "default": "",
+          "description": "Optional API key for the Skill Forge Studio backend (if protected)."
+        },
+        "clawdcontext.skillForge.autoStart": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically start the Skill Forge Studio backend when the extension activates.",
+          "markdownDescription": "Automatically start the Skill Forge Studio Python backend when the extension activates.\n\nRequires `skill_forge_studio/` with a Python venv in the workspace."
         }
       }
     },

src/commands/index.ts

@@ -12,3 +12,4 @@ export { showDashboard } from './showDashboard';
 export { cerDiffCommand } from './cerDiffTracking';
 export { applyConfigPreset } from './configPresets';
 export { exportDashboard } from './dashboardExport';
+export { openSkillForge } from './skillForge';