CtrlK
BlogDocsLog inGet started
Tessl Logo

saga

Run an autonomous, spec-driven development "saga" for medium-to-large features using an orchestrator agent and a fleet of worker subagents. Use this skill whenever the user invokes /saga, asks to autonomously build a sizable feature end-to-end with minimal human intervention, wants a comprehensive spec broken into milestones and tasks with airtight validation criteria before parallelized implementation, or wants an orchestrator to delegate implementation to worker agents while preserving its own context window. Trigger on phrases like "run a saga", "autonomously implement this feature", "spec it out then build it with subagents", "orchestrate this big feature end-to-end", or "build this with workers and validate each step". Also use this skill when asked to continue, resume, or pick up an existing saga from its saga directory (e.g. under ~/.sagas).

73

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered workflow skill: phases are clearly sequenced with validation as a first-class, looped checkpoint at task, milestone, and saga levels; mechanics are concrete (branch conventions, git commands, directory layout); and detail is properly pushed to three real, one-level-deep reference files. The only slack is a handful of rationale sentences and the reliance on named tools whose call shapes are assumed.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and teaches nothing Claude already knows; nearly every line is instruction ("Use `run_agents` to launch workers", "git worktree add ../saga-<saga-name>-m<M>t<T> -b ...", "Record these findings in `SAGA.md`"). A few motivational/rationale sentences ("The whole method rests on one bet...", "a stale log means a lost saga") could be trimmed, matching anchor 4 ('Efficient; minor instances of over-explanation') rather than 5's 'every token earns its place'.

4 / 5

Actionability

Concrete, usable mechanics abound: an exact branch-naming convention with a worked example (saga/dark-mode-20260609-0028/m1t2-setup-tokens), copy-pasteable git commands (worktree add, `git branch --list '*saga/<saga-name>/*'`, `git worktree remove <path> --force`), a concrete directory tree, and a per-worker contract with explicit reporting fields. It sits at anchor 4 ('Mostly executable guidance... with minor gaps') rather than 5 because the core spec-drafting and validation content is delegated to reference files and the `run_agents`/`ask_user_question` tool interfaces are named without their exact call shapes.

4 / 5

Workflow Clarity

Three explicitly sequenced phases with numbered steps, and validation is first-class throughout: worker "Self-validate in a loop" (fix→validate until criteria pass), milestone-level integration validation (step 4 of the orchestration loop), blocked-task escalation handling, Phase 3 exit-criteria verification, and a user-acceptance loop ('capture them as new tasks, run a focused Phase 2 mini-loop... Repeat until the user accepts'). This matches anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery').

5 / 5

Progressive Disclosure

The body is a navigable overview with clear section structure, and the three referenced files (references/saga-spec-template.md, references/validation-strategies.md, references/continuing-a-saga.md) all exist in the bundle, are one level deep (the only cross-reference is a sibling pointer from the template to validation-strategies.md, not a chain), and are each annotated with when to read them both inline and in a dedicated 'Reference files' section. Detail (templates, validation strategies, resume procedure) is appropriately split out. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities in third person, gives explicit 'Use when' guidance with a rich set of natural trigger phrases including synonyms and a resume path, and carves out a distinct niche. The only weakness is that a couple of the broad trigger phrases create minor overlap risk with closely related orchestration skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: "Run an autonomous, spec-driven development 'saga'", "turn a rough prompt into an airtight spec" implied via "comprehensive spec broken into milestones and tasks with airtight validation criteria", "delegate implementation to worker agents while preserving its own context window", and "continue, resume, or pick up an existing saga from its saga directory". It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' rather than 4, since it covers planning, delegation, validation, and resumption with no significant capability gaps.

5 / 5

Completeness

The first sentence answers 'what' concretely (autonomous spec-driven saga via orchestrator and worker fleet) and the explicit "Use this skill whenever..." and "Trigger on phrases like..." clauses answer 'when' with concrete trigger phrases, including a secondary resume condition. This matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; a 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

It explicitly enumerates natural user phrases: "run a saga", "autonomously implement this feature", "spec it out then build it with subagents", "orchestrate this big feature end-to-end", "build this with workers and validate each step", plus the /saga invocation and the synonym cluster "continue, resume, or pick up". This matches the anchor 'Comprehensive coverage of natural terms including synonyms' (file extensions are inapplicable to a workflow skill, and the ~/.sagas path hint covers the artifact form); it is well above anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The skill has a clear niche — the distinctive "saga" term, the /saga invocation, the ~/.sagas directory, and the spec-first-then-delegate workflow — but a few listed triggers such as "autonomously implement this feature" and "build a sizable feature end-to-end" could plausibly fire for a generic autonomous-implementation or subagent-orchestration skill. This fits anchor 4 ('Mostly distinct; minor overlap risk with closely related skills') rather than 5's 'minimal conflict risk'.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
warpdotdev/common-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.