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
64
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/write-spike/SKILL.mdQuality
Discovery
89%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 solid description that clearly communicates when to use the skill with multiple explicit trigger scenarios and natural engineering terminology. Its main weakness is that the 'what it does' portion could be more specific about the concrete actions performed beyond just naming the outputs. Overall it performs well for skill selection purposes.
Suggestions
Add 1-2 more specific actions describing what the spike doc contains or what analysis is performed, e.g., 'maps service dependencies, estimates complexity, identifies risks, and produces a structured spike doc with diagrams and a private notes file'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (initiative spikes, engineering discovery) and mentions some outputs (structured spike doc, diagrams, private notes file), but doesn't list the specific concrete actions performed within the spike process (e.g., analyzing dependencies, mapping service interactions, estimating effort). | 2 / 3 |
Completeness | Clearly answers both 'what' (produces a structured spike doc with diagrams and a private notes file) and 'when' (starting a new initiative spike, investigating technical feasibility, assessing impact across services, writing an engineering discovery document) with explicit trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would actually say: 'spike', 'technical feasibility', 'impact across services', 'engineering discovery document', 'initiative'. These cover the common vocabulary engineers use when requesting this type of work. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of 'spike', 'technical feasibility', 'engineering discovery document', and the specific outputs (spike doc with diagrams and private notes file) creates a clear niche that is unlikely to conflict with other skills like general documentation or architecture skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a sophisticated, well-structured spike investigation workflow with excellent phase sequencing, knowledge classification, and validation checkpoints. Its main weaknesses are the lack of executable examples (commands, templates, concrete tool invocations) and the absence of referenced bundle files (spike-template.md, company-config.yaml) that would validate its progressive disclosure claims. The content is moderately verbose but most of it is genuinely instructive rather than padding.
Suggestions
Include the referenced `spike-template.md` and `company-config.yaml` as bundle files, or inline minimal versions — currently these are critical dependencies that don't exist in the bundle.
Add concrete, executable examples for key tool interactions (e.g., actual MCP tool call patterns for Jira/Slack/Hindsight, specific CLI commands for codebase discovery like `grep -r 'keyword' --include='*.py'`).
Consider splitting the DB Impact Analysis (Phase 2.4) and Delegation Discussion Guide (Phase 2.5) into separate referenced files to reduce the main skill's density.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly long but most content earns its place — the phase structure, knowledge classification system, and quality gates are genuinely novel guidance. However, some sections are verbose (e.g., the role-play preamble, the Red Flags table restates things already covered in the process), and the invocation examples could be tighter. | 2 / 3 |
Actionability | The skill provides a detailed process with specific steps, tool references, and classification categories, which is strong. However, it lacks executable code/commands — there are no concrete CLI examples for fetching tickets, querying Hindsight, or creating task files. Many instructions are procedural descriptions rather than copy-paste-ready commands or templates. The spike template is referenced but not included in the bundle. | 2 / 3 |
Workflow Clarity | The workflow is exceptionally well-sequenced with a clear Mermaid flowchart, four mandatory phases, explicit scope checks with decomposition criteria, a knowledge classification system (A/B1/B2/C) that drives next actions, quality gates as validation checkpoints, and a self-review + grill-me feedback loop before output. The 'every phase is mandatory' directive and Red Flags table serve as guardrails. | 3 / 3 |
Progressive Disclosure | The skill references `spike-template.md` and `company-config.yaml` as external files, which is good progressive disclosure. However, neither file is provided in the bundle, making it impossible to verify the references work. The skill itself is quite long (~200+ lines) and some content like the DB impact analysis details or delegation guide structure could be split into referenced files. The single-file approach creates a dense read. | 2 / 3 |
Total | 9 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
4e8e219
Table of Contents
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.