CtrlK
BlogDocsLog inGet started
Tessl Logo

implement-mainspec

Implements a mainspec end-to-end by auto-detecting mode. Sequential mode (≤3 slices) commits slices in order on the current `feature/<feature>` branch. Parallel mode (>3 slices) uses dependency-aware tiered execution with per-slice worktrees, branches, PRs, and auto-merge into the feature branch. Agent-first — invoked headless by the harness dispatcher with the feature slug as its single argument. No human-in-the-loop, no approval gates.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

The canonical home for this skill is implement-mainspec in tdg-ninja/context-specs-factory-ai

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

An exceptionally actionable, well-validated orchestration skill: copy-paste commands, deterministic mode detection, idempotent resume, and bounded feedback loops. Weaknesses are limited to moderate repetition of the no-approval/no-human points and small inaccuracies in the References section's read-triggers.

Suggestions

Fix the References section trigger: the subagent prompt template is needed in Phase 2 (Tier 0) and Phase 3 (Parallel Tiers), not 'Phase 4', and release-strategy.md's 'when the user asks about releasing' should be reworded for a headless context (e.g., 'when preparing the eventual feature/<feature> -> main PR').

Trim repeated statements: the no-approval-gate point, the 'archaeological evidence' branch-retention rationale, and the Guidelines DO/DON'T recaps each appear multiple times and could be stated once.

Consider moving the Signal Processing and TODO Structure sections into a reference file, since they describe subagent-side behavior already covered by the prompt template reference.

DimensionReasoningScore

Conciseness

The body is dense procedural instruction (commands, state-recovery matrices, naming conventions) with little concept explanation, but repetition is noticeable: the no-approval-gate point is restated roughly eight times, the 'archaeological evidence' branch-retention rationale appears three times, and the Guidelines DO/DON'T section largely recaps body content. This matches anchor 4 (minor instances that could be trimmed) rather than 5 (every token earns its place).

4 / 5

Actionability

Fully executable guidance throughout: copy-paste bash for worktree creation and PR merges ('git worktree add ... -b ... feature/<feature>', 'gh pr merge <pr-number> --merge'), deterministic pre-condition checks, exact PR-state lookup commands ('gh pr view slice/<number>-<kebab-name> --json state -q .state'), exact naming conventions, and a concrete script invocation with parsed JSON output. Matches the 5 anchor.

5 / 5

Workflow Clarity

Phases 0-5 are clearly sequenced with explicit validation (pre-conditions, preflight bootstrap check, signal fix-retry loop bounded by max_signal_iterations: 3), idempotent resume detection, merge-conflict recovery, failure-to-exit-to-dispatcher-retry feedback loops, and TODO checklists. Slight phase-numbering overlap between sequential and parallel modes is mitigated by per-section 'Applies only to' labels, so it matches 5 rather than 4.

5 / 5

Progressive Disclosure

Three real, one-level-deep reference files (subagent-prompt-template.md, error-handling.md, release-strategy.md) each with a when-to-read signal, plus a scripts directory; all verified to exist. Minor gaps: the References section says to read the subagent template 'when spawning subagents in Phase 4' (spawning actually happens in Phase 2/Tier 0 and Phase 3), and release-strategy.md is triggered by 'when the user asks about releasing' in a skill that explicitly has no human in the loop. Matches anchor 4 (minor organization gaps) rather than 5.

4 / 5

Total

18

/

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: specific, comprehensive, third-person, and highly distinct within its niche. The main weakness is that trigger framing is mechanical dispatcher jargon rather than natural user language, and the 'when' is stated as invocation mechanics instead of an explicit use-condition.

Suggestions

Add an explicit trigger phrase of the form 'Use when the dispatcher needs to implement all slices of a mainspec feature' so the when-condition is stated directly rather than as invocation mechanics.

Include natural-language synonyms (e.g., 'implement all slices', 'build a feature from its spec') alongside the jargon terms so the skill is discoverable by phrasing beyond the harness dispatcher's exact vocabulary.

DimensionReasoningScore

Specificity

Lists multiple concrete actions covering both modes comprehensively: 'Implements a mainspec end-to-end by auto-detecting mode', 'commits slices in order on the current feature/<feature> branch', 'per-slice worktrees, branches, PRs, and auto-merge'. No vague filler and no coverage gaps, matching the 5 anchor rather than 4.

5 / 5

Completeness

The 'what' is explicit and detailed, and the 'when' is present as equivalent explicit trigger guidance ('invoked headless by the harness dispatcher with the feature slug as its single argument'). It is framed as invocation mechanics rather than a direct use-condition, so it matches anchor 4 ('when' could be more explicit) rather than 5, and clearly not 3 since the when is explicit rather than merely implied.

4 / 5

Trigger Term Quality

Good keyword coverage with domain-natural terms ('mainspec', 'slices', 'worktrees', 'PRs', 'auto-merge', 'feature branch', 'dispatcher'), but the vocabulary is jargon-heavy and missing common variations or synonyms a user might naturally say, so it fits 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Highly distinct vocabulary ('mainspec', 'slice-implementer', 'feature/<feature>', 'dispatcher') establishes a clear niche with minimal conflict risk against other skills, matching the 5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (540 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository
tdg-ninja/context-specs-claude-code
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.