agentleFS
precise-alloyprecise-alloy/ritus/skills/start-ritus/SKILL.md

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
  1. Distinctive:

    No hallucinated features - if unclear, stop and ask.

    line 30
  2. Distinctive:

    Stop on errors - compile fail, test fail, 4xx/5xx.

    line 31
  3. Distinctive:

    Before starting work, check which skill matches the user's intent by reading the available skill descriptions.

    line 53
  4. Distinctive:

    When multiple skills could apply, use this order:

    line 85

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. User's explicit instruction in the current conversation
  2. Primary rules (CLAUDE.md / copilot-instructions.md)
  3. Project context (docs/PROJECT_CONTEXT.md)
  4. Active skill instructions
  5. This skill (workflow defaults)

Golden rules (defaults - primary rules can override)

  1. Classify before loading context - triage first.
  2. Minimal change - no unsolicited refactors.
  3. Grep before edit - confirm paths exist before touching files.
  4. No hallucinated features - if unclear, stop and ask.
  5. Stop on errors - compile fail, test fail, 4xx/5xx.
  6. Grep before claiming - cite file:line when 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:

ThoughtReality
"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:

  1. Process skills first (brainstorm, debug, triage, address-feedback) - these determine HOW to approach the task
  2. Implementation skills second (execute-task, ticket-review) - these guide execution
  3. 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.).

Download now (ZIP)

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.