skill-based-architecture
- Repo stars 264
- Author repo skill-based-architecture
skill-based-architecture (Cursor Registration Entry)
This is the Cursor discovery entry. Formal skill content lives at the repo root — read 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:
- Read
SKILL.md. - Read
references/self-hosting-routing.yaml. - Match by
labels,trigger_examples, and task intent. - Read only that route's
required_reads, then follow itsworkflow. - If no route matches, use the
otherroute.
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 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.
- Fluxly category
- 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
- Author / version / license
- @WoJiSama · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. Task routes live in references/self-hosting-routing.yaml. For every new task: Read SKILL.md.
Cursor's agentskill 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 description field. Drift between the two = Cursor…
# 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. Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
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 · triggerexamples · requiredreads · workflow · other · agentskill · .cursor/skills/
body sha256 -> 81bb882e6d75
Decide Fit First
Design Intent
How To Use It
Boundaries And Review