CtrlK
BlogDocsLog inGet started
Tessl Logo

specification-writing

Write technical specs that let agents implement autonomously. Use for "write a spec", "plan this feature", "create a planning doc".

71

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

A well-structured, highly actionable specification-writing guide with strong workflow gating, checklists, and a properly signaled one-level-deep reference. Its main weakness is length — several philosophical passages restate points and could be trimmed without losing guidance value.

Suggestions

Tighten the Core Philosophy and Maintainer-Time Contract prose: the six philosophy bullets and surrounding reframes overlap the structural guidance that follows, so collapsing them would cut tokens without losing actionability (conciseness).

Consolidate repeated framing such as "A spec is a launching pad, not a script to follow" and the closing sweet-spot sentence, which restate the opening philosophy (conciseness).

Consider moving the long Catalogs and Call Sites before/after worked examples into a reference file, keeping only the pattern explanation inline, to further reduce the main-file footprint (progressive_disclosure).

DimensionReasoningScore

Conciseness

The ~430-line body avoids explaining concepts Claude already knows and is mostly prescriptive, but carries redundant philosophical framing (e.g., "A spec is a launching pad, not a script to follow" restating the Core Philosophy bullets) and prose that could be tightened. It is efficient but not lean enough that every token earns its place, so it lands at 2 rather than 3 and is well above the padded score-1 anchor.

2 / 3

Actionability

It provides concrete, copy-paste-ready templates for every section, a concrete naming convention ("specs/YYYYMMDDThhmmss-feature-name.md"), decision-class tables, and verbatim before/after call-site examples. Per the instruction-only scoring note, the absence of executable code is not penalized because the guidance is highly actionable.

3 / 3

Workflow Clarity

The spec-writing process is sequenced via the document structure, gated by the one-sentence-test ("the spec is not ready"), and includes an explicit Build/Prove/Remove wave ordering with a verification checkpoint ("Do not schedule deletion before verification passes") plus checkbox checklists. This matches the score-3 anchor of clear sequence with explicit validation steps and feedback loops.

3 / 3

Progressive Disclosure

The References section gives condition-based, one-level-deep loading (decision-hygiene.md, verified to exist with no nested references) and the main file keeps core templates inline while pushing deeper failure-mode detail to the reference. It matches the score-3 anchor of a clear overview with well-signaled one-level-deep references and easy navigation.

3 / 3

Total

11

/

12

Passed

Description

90%

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, concise description that pairs a concrete capability statement with explicit, natural trigger phrases covering both what and when. The only gap is specificity breadth — a single action rather than an enumerated action set.

DimensionReasoningScore

Specificity

It names one concrete action ("Write technical specs that let agents implement autonomously") but does not list multiple specific actions, matching the score-2 anchor that names a domain and some actions without being comprehensive. It is not vague (ruling out 1) and does not enumerate multiple distinct actions (ruling out 3).

2 / 3

Completeness

It explicitly answers both what ("Write technical specs that let agents implement autonomously") and when (the "Use for ..." trigger phrases), matching the score-3 anchor that clearly answers both with explicit triggers.

3 / 3

Trigger Term Quality

The "Use for 'write a spec', 'plan this feature', 'create a planning doc'" clause gives natural phrases a user would actually say, with good coverage of common variations. It is far above the jargon-only or single-keyword anchors for 1 and 2.

3 / 3

Distinctiveness Conflict Risk

The specification-writing niche with distinct spec/planning-doc triggers is clearly distinguishable and unlikely to fire for unrelated skills, matching the score-3 anchor. While 'plan this feature' has slight overlap with general planning, the spec-writing framing keeps it distinct, so it stays above 2.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 suspicious

Warning

Total

15

/

16

Passed

Repository
EpicenterHQ/epicenter
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.