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.md has 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/wojisamaskill-based-architecture.svg)](https://yunodb.com/tools/wojisamaskill-based-architecture?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/wojisamaskill-based-architecture?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/wojisamaskill-based-architecture.svg" alt="Featured on YunoDB" height="20"></a>