CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cavecrew

When to delegate to `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit) or `cavecrew-reviewer` (diff review) instead of working inline or using `Explore`. Their output is compressed, so main context lasts longer.

69

Quality

87%

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

The canonical home for this skill is cavecrew in JuliusBrussee/caveman

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

An exemplary routing skill body: a decision table, verbatim output contracts, numbered chaining patterns, and explicit anti-patterns, all with near-zero padding. The only gaps are a missing example invocation for the subagents and an unstated recovery loop after a reviewer audit.

DimensionReasoningScore

Conciseness

Lean and dense throughout: a task-to-agent decision table, exact output-contract templates, and a one-line rule of thumb ("if you'd want the subagent's output in 1/3 the tokens, pick cavecrew"). Nothing explains concepts Claude already knows — even the "Why this exists" section is three sentences of skill-specific rationale (tool results injected verbatim into main context), not generic padding. Matches the 'every token earns its place' anchor.

5 / 5

Actionability

Highly actionable for an instruction-only skill: the decision table gives exact task→agent mappings, output contracts are specified verbatim ("<path:line-range> — <change ≤10 words>" / "totals: N🔴 N🟡 N🔵 N❓"), and chaining patterns are concrete ("Spawn 2-3 `cavecrew-investigator` calls in one message (different angles: defs vs callers vs tests)"). Not 5: no example of the actual prompt/invocation text to hand a cavecrew agent, a minor gap; not 3 because the guidance is specific and executable, not pseudocode-level.

4 / 5

Workflow Clarity

The main "Locate → fix → verify" chain is numbered 1-2-3 with the reviewer as an explicit audit step, and the builder contract embeds a verification checkpoint ("verified: <re-read OK | mismatch @ path:line>"). Not 5: there is no explicit recovery loop after the reviewer finds issues (the chain ends at "audits the diff") and the mismatch case has no stated retry step; not 3 because checkpoints are present and clearly sequenced, and this is not a destructive/batch skill so no cap applies.

4 / 5

Progressive Disclosure

Single-file skill with no references/, scripts/, or assets/ bundle and no external files referenced; nothing that belongs in a separate file is inlined — output contracts and chaining patterns are short and needed at a glance. Sections (when to use vs alternatives, output contracts, chaining patterns, what NOT to do) are well-organized and navigable, matching the well-organized single-file case.

5 / 5

Total

18

/

20

Passed

Description

83%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 tight, third-person routing description that names all three agents, maps each to a concrete task, states the differentiating benefit (compressed output preserving main context), and opens with an explicit when-to-use clause. Its only weaknesses are un-enumerated trigger variations and inherent overlap with the built-in agents it replaces.

DimensionReasoningScore

Specificity

Names three concrete per-agent capabilities — "(locate code)", "(1-2 file edit)", "(diff review)" — plus the mechanism "Their output is compressed, so main context lasts longer", which matches the 'several specific actions, minor gaps' anchor. Not 5: it never spells out what "locate code" spans (finding definitions, callers, uses), so coverage is not fully comprehensive; not 3 because it lists three distinct concrete actions rather than only 1-2.

4 / 5

Completeness

Explicitly answers both questions: the opening "When to delegate to `cavecrew-investigator` ... or `cavecrew-reviewer` (diff review) instead of working inline or using `Explore`" is a full when-clause with per-task triggers, and the what is stated via each agent's function plus "Their output is compressed, so main context lasts longer". Voice is third person ("Their output"), so no voice penalty applies. Not 4 because the when-clause is already explicit and task-mapped, not merely present-but-vague.

5 / 5

Trigger Term Quality

Contains natural, sayable terms — "locate code", "1-2 file edit", "diff review", "delegate", "Explore", "context" — giving good coverage a user or Claude would echo. Not 5: common variations like "find where X is defined", "what calls Y", "search the codebase", or "review my changes/diff" are absent; not 3 because the terms go beyond bare domain naming and include the natural task verbs.

4 / 5

Distinctiveness Conflict Risk

The compressed-output delegation niche is distinct and the description explicitly contrasts itself with "working inline or using `Explore`", matching 'mostly distinct; minor overlap risk'. Not 5: the trigger domain (code location, edits, diff review) inherently overlaps with built-in Explore and code-review skills, so mis-trigger risk is more than minimal.

4 / 5

Total

17

/

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

JuliusBrussee/caveman

Path

plugins/caveman/skills/cavecrew/SKILL.md

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.