CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-spike

Use when starting a new initiative spike, investigating technical feasibility, assessing impact across services, or writing an engineering discovery document — produces a structured spike doc with diagrams and a private notes file

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

70%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-sequenced, checkpoint-rich process skill with strong conciseness and workflow clarity, whose document template, company config, and several companion skills are referenced but absent from the bundle. Actionability suffers because Phase 3 depends entirely on a template file that is not shipped, and external tool invocations have no inline fallback.

Suggestions

Bundle `spike-template.md` (and `company-config.yaml`) in the skill directory or inline the template's section structure in SKILL.md — Phase 3.2's 'Every section must be populated' is unactionable without the referenced template.

Provide inline fallback instructions for external dependencies (grill-me, devflow:codebase-walkthrough, devflow:retain-learning, Nimbalist task-file format) so the phases remain executable when those skills/tools are unavailable.

Trim the redundant persona framing and the duplicated 'Every section must be populated' line in section 3.2 to tighten token usage.

DimensionReasoningScore

Conciseness

The body is dense and imperative — phases, tables, and bullet directives with almost no explanation of concepts Claude already knows (e.g., the DB section jumps straight to "CREATE INDEX CONCURRENTLY, pg_repack, gh-ost, start batch=1000"). Minor trimmable redundancy exists: the persona paragraph ("You are a senior staff engineer... You've seen spikes that changed architectural direction") and the duplicated instruction "Every section must be populated" in 3.2.

4 / 5

Actionability

Concrete guidance is substantial (parallel subagent assignments, category classification rules, explicit save paths, a 10-row quality gates table, specific DB techniques), but key details are missing: "Follow the template in `spike-template.md`" and "Read `company-config.yaml` from the skill directory" point to files that do not exist in the bundle, and external skills ("Invoke grill-me", "devflow:codebase-walkthrough", "devflow:retain-learning", Nimbalist task files) are invoked with no bundled definitions or inline fallbacks, so the document-generation phase is not executable as shipped.

3 / 5

Workflow Clarity

The four phases are explicitly sequenced (reinforced by a Mermaid flowchart and "Every phase is mandatory. Do not skip phases."), with validation checkpoints throughout: a scope check after Phase 1 with concrete thresholds ("30+ spike goals, 10+ external dependencies"), user decision points ("Decide now, discuss with team, or defer?"), a 10-gate quality checklist in 3.4, and a self-review feedback loop in 4.1 ("Placeholder scan, internal consistency, scope check, ambiguity check. Fix inline.") plus grill-me adversarial review in 4.2. Defaults and safety rails are explicit ("Default: keep local. Never auto-publish.").

5 / 5

Progressive Disclosure

Section structure per phase is good and references are clearly signaled one level deep ("REQUIRED REFERENCE: Follow the template in `spike-template.md` (same directory as this skill)"), but no bundle directory exists and neither referenced file (spike-template.md, company-config.yaml) is present, so the navigation chain is broken and the skill functions as a monolith with dangling references. This is between anchor 3 (references present but the organization is incomplete) and anchor 2, landing at 3 because the in-body structure itself is well organized.

3 / 5

Total

15

/

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 strong description with an explicit 'Use when' clause, concrete natural-language triggers, a clearly stated deliverable, and third-person voice throughout. Its only gaps are a few missing synonyms (POC, proof of concept) and slightly broad feasibility-investigation phrasing that creates minor overlap risk.

DimensionReasoningScore

Specificity

Concrete deliverables are named — "produces a structured spike doc with diagrams and a private notes file" — alongside specific activities like "investigating technical feasibility" and "assessing impact across services". It falls short of anchor 5 because it does not enumerate multiple specific actions of the process itself (the anchors' comprehensiveness), but is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both questions are answered explicitly and with concrete trigger phrases: an explicit "Use when starting a new initiative spike, investigating technical feasibility, ..." clause for 'when', and "produces a structured spike doc with diagrams and a private notes file" for 'what'. The 'when' is highly explicit with four distinct conditions, matching anchor 5 rather than anchor 4 ('when could be more explicit').

5 / 5

Trigger Term Quality

Natural trigger phrases a user would say include "initiative spike", "technical feasibility", "engineering discovery document", and "assessing impact across services". Common synonyms such as 'POC', 'proof of concept', or 'spike document' as a standalone noun are only partially covered, matching anchor 4's 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — 'spike' / 'engineering discovery document' with a specific two-file deliverable — making wrong-skill triggering unlikely. It is not anchor 5 because broader phrases like "investigating technical feasibility" and "assessing impact across services" could overlap with general research/architecture-review skills.

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

AndreJorgeLopes/proof-of-skill

Path

skills/write-spike/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.