start-ritus
Skill1 starsChanged 4 months agoMITView on GitHub
Use when starting any conversation - establishes skill routing and golden rules for the workflow, requiring skill invocation before ANY response including clarifying questions
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 30
No hallucinated features - if unclear, stop and ask.
- Distinctive: line 31
Stop on errors - compile fail, test fail, 4xx/5xx.
- Distinctive: line 53
Before starting work, check which skill matches the user's intent by reading the available skill descriptions.
- Distinctive: line 85
When multiple skills could apply, use this order:
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Subagent guard: If you were dispatched as a subagent to run a worker skill per
skills/shared/dispatch.md(verify-task, pr-review, execute-task, requirement-analysis, or task-generation), skip this skill entirely. Run only the skill you were dispatched to execute.Mandatory skill check: Before responding to any task - including clarifying questions - check whether an available skill applies. If a skill covers your task, you must invoke it via your platform's skill mechanism. Do not skip this check. This is not optional.
Ritus
Source of truth: this skill + workflow skills. Project data:
docs/PROJECT_CONTEXT.md. User behavioral rules: CLAUDE.md / copilot-instructions.md (override workflow defaults).
Instruction priority
- User's explicit instruction in the current conversation
- Primary rules (CLAUDE.md / copilot-instructions.md)
- Project context (
docs/PROJECT_CONTEXT.md) - Active skill instructions
- This skill (workflow defaults)
Golden rules (defaults - primary rules can override)
- Classify before loading context - triage first.
- Minimal change - no unsolicited refactors.
- Grep before edit - confirm paths exist before touching files.
- No hallucinated features - if unclear, stop and ask.
- Stop on errors - compile fail, test fail, 4xx/5xx.
- Grep before claiming - cite
file:linewhen asserting facts about existing code.
Workflow tracking
MANDATORY: When a core workflow skill (brainstorm/triage/ticket-review/requirement-analysis/task-generation/execute-task/verify-task/pr-review/address-feedback/wrap-up/comprehension/debug) is invoked, its first action - before any work - is to create a todo list containing every step in that skill's own TODO: block, copied verbatim (including any handoff line; terminal skills have none). Mark items done as you go. This ensures you never stop mid-chain and never skip steps in long context windows.
Never collapse a skill into one todo item (e.g. a single Brainstorm: <task> item) and never build a one-item-per-skill chain checklist. Each invoked skill contributes its own full list of steps; the chain advances because a skill's last step invokes the next skill, which then creates its own step list.
Skip for TRIVIAL tasks - a single-step fix doesn't need a TODO.
Expected workflow chains (reference map only - NOT a todo template; each skill creates its own step TODO)
- Requirement with ticket: triage → ticket-review → user approval → execute + verify → pr-review → wrap-up → comprehension
- Exploratory question: brainstorm → triage → ticket-review → user approval → execute + verify → pr-review → wrap-up → comprehension
- Bug report: debug (investigate + approve fix) → execute + verify → pr-review → wrap-up → comprehension
- PR review feedback: address-feedback → execute + verify → [pr-review re-check → wrap-up → comprehension]
Skill invocation
Terminology: "Invoke" = trigger a skill via your platform's skill mechanism (user or system action). "Load" = a skill reading another skill's content as a companion standard (skill-to-skill action).
Before starting work, check which skill matches the user's intent by reading the available skill descriptions.
Invoke the matching skill via your platform's skill mechanism. Each skill's ## Handoff section defines what it returns and its TODO
update - follow it, do not pre-plan the full chain.
Dispatch
The dispatch contract - the spawn-then-invoke rule, how a "dispatch <skill> subagent" TODO item runs, fix-task creation, the circuit
breaker, and per-worker run config (model / effort / tools) - lives in skills/shared/dispatch.md. Load it before
walking a driving TODO. It is the single source; worker skills never load it, keeping dispatch out of subagents.
Shared reference docs under skills/shared/ (e.g. dispatch.md, remote-api-access.md) are static within a session.
Load each the first time you need it and reuse it from context afterward - when a shared doc is already in your context,
work from that copy instead of re-reading it.
Red flags - stop and check for applicable skills
These thoughts mean STOP - you're rationalizing:
| Thought | Reality |
| "This is just a simple question" | Questions are tasks. Check for skills. |
| "I need more context first" | Skill check comes BEFORE clarifying questions. |
| "Let me explore the codebase first" | Skills tell you HOW to explore. Check first. |
| "I can check git/files quickly" | Files lack conversation context. Check for skills. |
| "This doesn't need a formal skill" | If a skill exists, use it. |
| "I remember this skill" | Skills evolve. Read current version. |
| "The skill is overkill" | Simple things become complex. Use it. |
| "I'll just do this one thing first" | Check BEFORE doing anything. |
| "I know how to debug this" | Use the debug skill. It prevents confirmation bias. |
Skill priority
When multiple skills could apply, use this order:
- Process skills first (brainstorm, debug, triage, address-feedback) - these determine HOW to approach the task
- Implementation skills second (execute-task, ticket-review) - these guide execution
- Standard skills alongside (code-conventions, testing-policy, tdd, security, definition-of-done) - these are loaded by the implementation skill when applicable
Output format
Each subagent reports using the output format defined in its own skill (execute-task, verify-task, pr-review, etc.).
In this repository21 other files it gives its agents.
- address-feedbackSkill
- brainstormSkill
- code-conventionsSkill
- comprehensionSkill
- debugSkill
- definition-of-doneSkill
- execute-taskSkill
- migrate-docsSkill
- pr-reviewSkill
- repo-scanSkill
- requirement-analysisSkill
- securitySkill
- setupSkill
- syncSkill
- task-generationSkill
- tddSkill
- testing-policySkill
- ticket-reviewSkill
- triageSkill
- verify-taskSkill
- wrap-upSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

