SKILL.md
Using Ring (Orchestrator Protocol)
When to use
- Every conversation start (automatic via SessionStart hook)
- Before ANY task (check for applicable skills)
- When tempted to operate tools directly instead of delegating
Skip when
- Never skip - this skill is always mandatory
<EXTREMELY-IMPORTANT> If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST read the skill. IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT. </EXTREMELY-IMPORTANT>
⛔ 3-FILE RULE: HARD GATE
DO NOT read/edit >3 files directly. PROHIBITION, not guidance.
≤3 files → Direct OK (if user requested)
>3 files → STOP. Launch agent. VIOLATION = 15x context waste.
Already at 3 files? STOP. Dispatch agent NOW.
Auto-Trigger Phrases: Mandatory Agent Dispatch
| User Phrase |
Mandatory Action |
| "fix issues", "fix remaining", "fix findings" |
Launch specialist agent |
| "apply fixes", "fix errors", "fix warnings", "fix linting" |
Launch specialist agent |
| "update across", "change all", "refactor" |
Launch specialist agent |
| "find where", "search for", "understand how" |
Launch Explore agent |
| "draw diagram", "visualize", "comparison table" |
Load ring:visualizing skill |
Mandatory First Response Protocol
- ☐ Check for
<MANDATORY-USER-MESSAGE> in additionalContext — display verbatim if present
- ☐ Orchestration decision: which agent handles this? (TodoWrite)
- ☐ Skill check: does any skill match this request?
- ☐ If yes → read and run the skill
- ☐ Announce skill/agent being used
- ☐ Execute
ORCHESTRATOR Principle
You dispatch agents. You do not operate tools directly.
| Instead of... |
Do this |
| Reading files |
Dispatch Explore agent |
| Grep/Glob chains |
Dispatch Explore agent |
| Manual multi-file edits |
Dispatch specialist agent |
| "Quick look" at codebase |
Dispatch Explore agent |
Exceptions (rare): User explicitly provides a file path AND explicitly requests you read it.
Which Agent?
| Task |
Agent |
| Explore/find/understand/search |
Explore |
| Plan implementation, break down features |
Plan |
| Multi-step research, complex investigation |
general-purpose |
| Code review |
9 default reviewers plus triggered conditional specialists via ring:reviewing-code skill |
| Implementation plan document |
ring:writing-plans |
Ring reviewers: always parallel in a single turn with multiple Task calls.
Pre-Action Checkpoint (before every Read/Grep/Glob/Bash)
1. FILES: ___ >3? → Agent. Already 3? → Agent now.
2. USER PHRASE: matches auto-trigger? → Agent
3. DECISION: [Agent: ___] or [Direct: reason]
TodoWrite Requirements
First two todos for ANY task:
- "Orchestration decision: [agent-name]"
- "Check for relevant skills"
If skill has checklist → TodoWrite for every item.
Summary
Before any task: orchestration decision → skill check → announce → execute. Before any tool use: complete pre-action checkpoint. Default answer: dispatch an agent. Exception is rare.