CtrlK
BlogDocsLog inGet started
Tessl Logo

cavecrew

Decision guide for delegating to caveman-style subagents. Tells the main thread WHEN to spawn `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit), or `cavecrew-reviewer` (diff review) instead of doing the work inline or using vanilla `Explore`. Subagent output is caveman-compressed so the tool-result injected back into main context is ~60% smaller — main context lasts longer across long sessions. Trigger: "delegate to subagent", "use cavecrew", "spawn investigator/builder/reviewer", "save context", "compressed agent output".

77

Quality

96%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

92%

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

This is a high-quality decision-guide skill that efficiently communicates when and how to delegate to cavecrew subagents. Its strengths are the crisp decision table, precise output contracts with parseable formats, and well-sequenced chaining patterns with built-in validation. The only notable weakness is the lack of progressive disclosure via bundle files for the individual subagent configurations, though the content is well-structured enough that this is a minor issue.

Suggestions

Consider splitting the three output contracts and their detailed formats into a referenced CONTRACTS.md file, keeping only a summary in the main SKILL.md to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The content is lean and efficient. The 'Why this exists' section borders on explanatory but earns its place by quantifying the token savings (2k vs 700 tokens), which is genuinely useful decision-making context. The table format for when-to-use is maximally dense. No padding or concept explanations Claude would already know.

3 / 3

Actionability

Provides concrete output contracts with exact formats (greppable patterns like `path:\d+`), specific terminal tokens for builder errors (`too-big.`, `needs-confirm.`), and clear chaining patterns with numbered steps. The decision table gives unambiguous routing for each task type. While there's no executable code, this is an instruction/decision skill where the guidance is fully actionable.

3 / 3

Workflow Clarity

The 'Chaining patterns' section provides three clearly sequenced workflows (locate→fix→verify, parallel scout, single-shot edit). The builder's output contract includes built-in validation ('verified: re-read OK | mismatch @ path:line') and explicit error states. The 'What NOT to do' section acts as guardrails against common missteps, and the locate→fix→verify chain includes a review step as validation.

3 / 3

Progressive Disclosure

The content is well-organized with clear sections and a logical flow from decision table → rationale → contracts → patterns → anti-patterns. However, there are no bundle files and no references to external files for the individual subagent configurations or detailed examples. For a skill of this complexity (three subagent types with contracts), splitting subagent details into referenced files could improve navigation.

2 / 3

Total

11

/

12

Passed

Description

100%

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

This is a strong skill description that clearly communicates its purpose (decision guide for subagent delegation), lists specific subagent types with their roles, explains the benefit (context compression), and provides explicit trigger terms. The description is concise yet comprehensive, with distinctive terminology that minimizes conflict risk. It uses appropriate third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: delegating to named subagents (cavecrew-investigator for locating code, cavecrew-builder for 1-2 file edits, cavecrew-reviewer for diff review), describes the compression benefit (~60% smaller), and explains the decision logic of when to spawn vs. work inline.

3 / 3

Completeness

Clearly answers both 'what' (decision guide for delegating to caveman-style subagents with specific roles) and 'when' (explicit trigger phrases listed, plus contextual guidance about when to spawn vs. work inline or use vanilla Explore).

3 / 3

Trigger Term Quality

Includes natural trigger terms users would say: 'delegate to subagent', 'use cavecrew', 'spawn investigator/builder/reviewer', 'save context', 'compressed agent output'. These cover both the specific tool names and the conceptual intent (saving context).

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with unique terminology ('cavecrew', 'caveman-compressed', specific subagent names like investigator/builder/reviewer). Very unlikely to conflict with other skills due to the specialized vocabulary and clear niche of subagent delegation with context compression.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
JuliusBrussee/caveman
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.