CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spike-investigation

This skill should be used when shaping work and needing to de-risk rabbit holes (technical unknowns, design gaps, interdependencies) by running timeboxed spikes, documenting proof, and updating the shaped concept with patches, cuts, and out-of-bounds so the work stays thin-tailed within the appetite.

67

Quality

84%

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

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.

A well-crafted instruction skill: a lean, jargon-assuming 7-step workflow with concrete decision menus and per-step template references, backed by a real one-level-deep bundle that all checks out. The only meaningful gap is the absence of an explicit validation checkpoint confirming timebox/success criteria before classifying the spike outcome.

DimensionReasoningScore

Conciseness

The body is lean and bullet-driven: it assumes competence (never explains what Shape Up, a breadboard, or a fit check is), keeps every section to decision-relevant guidance, and its only prose ("Spikes are not mini-projects. They exist to remove a tail of risk.") is load-bearing framing rather than padding. Every token earns its place, matching the top anchor; it is not a 4 because there is no over-explanation left to trim.

5 / 5

Actionability

For an instruction-only skill the guidance is highly concrete: a 7-step workflow, four named mitigation moves (patch/out-of-bounds/cut/spike), a five-field spike specification, three outcome classifications with follow-on decisions, and per-step pointers to specific templates. It falls short of fully executable (5) because step 4 "Execute the spike" and the wiring/integration/performance/state spike shapes remain necessarily abstract with no concrete worked steps or example embedded inline.

4 / 5

Workflow Clarity

Steps 1-7 are clearly numbered and sequenced, step 5 embeds an explicit decision branch (proceed/revise/drop) that acts as a checkpoint, and the Quality bar section is a checklist ("Timebox honoured", "Spike reduces risk *or* triggers a scope cut"). It sits below 5 because there is no explicit verify/re-validate loop — e.g. no step confirming the timebox or success criteria were actually met before classification — leaving minor validation gaps per the anchor.

4 / 5

Progressive Disclosure

SKILL.md is a clear overview-only workflow; all detail is delegated one level deep to real, existing files — templates/risk-register-template.md, spike-plan-template.md, spike-report-template.md (all verified present with substantive content), shapeup-risks-rabbit-holes-notes.md, and examples/sample-spike.md — each referenced inline at the step where it is needed and summarized in the Bundled resources section. Content is appropriately split with easy navigation, matching the top anchor exactly.

5 / 5

Total

18

/

20

Passed

Description

76%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 with an explicit when-clause and concrete named actions, clearly rooted in the Shape Up methodology. Its main weaknesses are jargon-heavy phrasing ("thin-tailed within the appetite") and missing more common synonyms a non-Shape Up user would naturally say.

Suggestions

Add natural trigger synonyms for broader audiences, e.g. "experiment", "prototype", "proof of concept", or "validate technical assumptions", so the skill fires when users describe the problem without Shape Up vocabulary.

Replace or gloss the jargon tail ("so the work stays thin-tailed within the appetite") with plain language such as "so the schedule risk stays bounded".

Clarify the trigger audience slightly (e.g. "when shaping a concept or planning a build") to further reduce overlap with general research/investigation skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "running timeboxed spikes, documenting proof, and updating the shaped concept with patches, cuts, and out-of-bounds" — matching the anchor for several specific actions with minor gaps. It is not a 5 because phrases like "so the work stays thin-tailed within the appetite" lean abstract rather than concrete, and not a 3 because multiple distinct actions are named, not just 1-2.

4 / 5

Completeness

It explicitly answers both questions: "This skill should be used when shaping work and needing to de-risk rabbit holes (technical unknowns, design gaps, interdependencies)" is an explicit, concrete when-clause, and the what is stated as running timeboxed spikes, documenting proof, and updating the shaped concept with patches/cuts/out-of-bounds. This matches the top anchor with concrete trigger phrases; a 4 would require the when-clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Relevant keywords like "rabbit holes", "spikes", "de-risk", and "shaping" appear, but common variations a user might naturally say — "experiment", "prototype", "proof of concept", "validate technical assumptions", "technical risk" — are absent. This matches the anchor for some relevant keywords missing common variations or synonyms; it is above a 2 because the included terms are domain-natural, and below a 4 because coverage is not broad.

3 / 5

Distinctiveness Conflict Risk

The Shape Up framing (spikes, rabbit holes, appetite, shaped concept) carves out a distinct niche with domain-specific triggers, matching the anchor for mostly distinct with minor overlap risk. It is not a 5 because a user asking broadly to "investigate" or "research a technical question" could plausibly trigger it or a general research skill interchangeably.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 4 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

marchatton/agent-skills

Path

.agents/skills/02-shape/spike-investigation/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.