skill based architecture
- Repo stars 264
- Author repo skill-based-architecture
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @WoJiSama · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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 by `labels`, `trigger_examples`, and task intent.
4. Read only that route's `required_reads`, then follow its `workflow`.
5. If no route matches, use the `other` route.
<!-- 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.
Sections and files
Listed in source order.
sections -> Quick Routing (survives context truncation) → Why this file exists
terms -> This is the Cursor discovery entry. · must stay identical · Task routes live in references/self-hosting-routing.yaml. · For every new task: 1. · Cursor's agentskill mechanism only scans .cursor/skills/. · The description above must stay identical to the root [SKILL.md](../../../SKILL.md) description field.
files/cmd -> references/self-hosting-routing.yaml · labels · trigger_examples · required_reads · workflow · other · agent_skill · .cursor/skills/
body sha256 -> 81bb882e6d75
Quick Routing (survives context truncation)
Task routes live in
references/self-hosting-routing.yaml. For every new task: ReadSKILL.md. Readreferences/self-hosting-routing.yaml. Match bylabels,trigger_examples, and task intent.Why this file exists
Cursor's
agent_skillmechanism only scans.cursor/skills/. Without this registration entry, the formal skill at repo root is invisible to Cursor. Thedescriptionabove must stay identical to the root SKILL.mddescriptionfield. Drift between the two = Cursor uses one activation rule while other harnesses use another.templates/skill/scripts/smoke-test.shautomatically verifies they match.