skill-based-architecture
A meta-skill that produces skills. Point it at any codebase and it distills the project's rules, workflows, and hard-won lessons into a dedicated skills/<name>/
What is skill-based-architecture?
A meta-skill that produces skills. Point it at any codebase and it distills the project's rules, workflows, and hard-won lessons into a dedicated skills/<name>/ directory — a project skill that becomes the single source of truth every AI agent (Cursor, Claude Code, Codex, Windsurf, Gemini) consults before every task.
Overview of skill-based-architecture
What it is
Skill-Based Architecture (SBA) is a meta-skill that produces project-specific skills. When pointed at any codebase, it distills the project's rules, workflows, and hard-won lessons into a dedicated skills// directory. That directory becomes the single source of truth that every AI agent (Cursor, Claude Code, Codex, Windsurf, Gemini) consults before every task. SBA is a skill, not an agent operating system, task database, or execution runtime.
Key features
- Centralizes scattered rules from multiple agent entry files into one project skill with a single owner.
- Routes each task to a specific workflow based on repository evidence, loading only decision-relevant context.
- Binds user-confirmed business meaning to the current code owner, keeping intent distinct from implementation facts.
- Verifies completion against the exact deliverables and terminal state requested by the task.
- Records proven, reusable learning only when it will change a future action, connecting lessons to the next task that needs them.
- Supports multiple harnesses (Cursor, Claude Code, Codex, Windsurf, Gemini, OpenCode) without maintaining separate rule systems.
Use cases
- Project instructions are duplicated or contradictory across agent entry files (e.g.,
AGENTS.md,CLAUDE.md, Cursor rules). - A single
SKILL.mdhas become hard to navigate due to growing content. - Recurring tasks need standard procedures, fitted verification, or reliable completion checks.
- Costly failures keep being rediscovered because lessons are stored but never activated.
- Several different coding agents need the same project knowledge without maintaining multiple rule systems.
Getting started
Claude Code: install with two commands. text /plugin marketplace add WoJiSama/skill-based-architecture /plugin install skill-based-architecture@skill-based-architecture Use /plugin marketplace update when you want the latest marketplace version. Cursor, Codex, Gemini, Windsurf, OpenCode, or another file-aware harness: clone it next to the target project. bash git clone https://github.com/WoJiSama/skill-based-architecture.git ../skill-based-architecture After installation, ask in ordinary language: “Use skill-based-architecture to organize this project's rules.” For a local clone, say: “Read ../skill-based-architecture/SKILL.md, then use it to organize this project's rules.” A small demo fixture is available in examples/simple-repo/.
License and pricing
The project is open source under the MIT license. Pricing type is open_source.
Based on the project's public README and repository metadata.