# Skill Based Architecture

Should be used when the user asks to "organize the project rules", "clean up scattered...

- Repository: https://github.com/WoJiSama/skill-based-architecture (619 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-09-20
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add WoJiSama/skill-based-architecture --skill skill-based-architecture -g -a claude-code -y`
Codex: `npx skills add WoJiSama/skill-based-architecture --skill skill-based-architecture -g -a codex -y`
Cursor: `npx skills add WoJiSama/skill-based-architecture --skill skill-based-architecture -g -a cursor -y`
Gemini CLI: `npx skills add WoJiSama/skill-based-architecture --skill skill-based-architecture -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add WoJiSama/skill-based-architecture`

## Description

This skill should be used when the user asks to "organize the project rules", "clean up scattered documentation", "把规则迁移到 skills 目录", "优化 skill 路由", "提高 description 命中率", or "减少薄壳重复维护". Activate when a SKILL.md is too large, rules are duplicated across agent entry files, task routing or trigger_examples miss natural user language, or templates / thin shells / validation scripts need drift-resistant maintenance.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# skill-based-architecture (Cursor Registration Entry)

**This is the Cursor discovery entry.** Formal skill content lives at the repo root, read [SKILL.md](../../../SKILL.md) immediately, then follow its design principles and workflow routing.

<!-- SELF_ROUTING_BLOCK_START -->
## Quick Routing (survives context truncation)

Task routes live in `references/self-hosting-routing.yaml`.

For every new task:
1. Read `SKILL.md`.
2. Read `references/self-hosting-routing.yaml`.
3. Match exactly one route by `labels`, `trigger_examples`, and task intent; if none matches, use `other`.
4. Follow only that route's `workflow`; the route does not preload project knowledge.
5. Let the workflow inspect the smallest evidence that can decide the next action, then pull later knowledge only when that unresolved decision requires it.
<!-- SELF_ROUTING_BLOCK_END -->

## Why this file exists

Cursor's `agent_skill` mechanism only scans `.cursor/skills/`. Without this registration entry, the formal skill at repo root is invisible to Cursor.

The `description` above **must stay identical** to the root [SKILL.md](../../../SKILL.md) `description` field. Drift between the two = Cursor uses one activation rule while other harnesses use another. `templates/skill/scripts/smoke-test.sh` automatically verifies they match.