CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-claude-spec

Auto-Claude spec creation and management. Use when creating feature specs, understanding spec pipeline phases, modifying requirements, or managing spec lifecycle.

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/auto-claude-spec/SKILL.md

The canonical home for this skill is auto-claude-spec in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

57%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-structured, highly actionable reference for the Auto-Claude spec pipeline, with concrete commands and complete artifact format examples throughout. Main weaknesses are a monolithic layout with no progressive disclosure of long detail sections, missing validation around destructive and batch operations, and some redundancy between the phase table and phase breakdown.

Suggestions

Add validation before destructive and batch operations: a status/spec check before 'rm -rf' deletion, per-item 'validate_spec.py --checkpoint requirements' inside the batch-creation loop, and a completion check after the loop.

Offload long detail into one-level-deep reference files (e.g. SPEC-FORMATS.md for the JSON/spec.md templates, PHASES.md for the phase breakdown, TROUBLESHOOTING.md) and keep SKILL.md as a quick-start overview with clearly signaled links.

Trim redundancy: drop the eight-phase bullet breakdown in favor of the complexity table, and remove the 'The system will:' narrative that restates what the phases already describe.

DimensionReasoningScore

Conciseness

The body is mostly dense commands, tables, and format templates, but the eight-phase breakdown largely restates the Dynamic Phase Selection table, the Overview re-lists what the spec.md format already shows, and 'The system will: 1. Ask about your feature/task...' states the obvious. This matches anchor 3: mostly efficient with some unnecessary explanation that could be trimmed.

3 / 5

Actionability

Nearly everything is copy-paste ready: 'python spec_runner.py --task "Add dark mode toggle to settings page"', 'python validate_spec.py --spec-dir .auto-claude/specs/001-feature --checkpoint all', a batch-creation loop, and a heredoc template. Minor gaps keep it at anchor 4 rather than 5: the troubleshooting hint '(Edit implementation_plan.json to reset context phase)' is not an executable command, and the working directory for 'python run.py --list' is never stated.

4 / 5

Workflow Clarity

The pipeline is clearly sequenced (Discovery through Validation, with a pre-build review checklist and re-validation after edits), but destructive and batch operations lack validation: 'rm -rf .auto-claude/specs/001-feature' has no confirmation or check, and the batch spec-creation loop validates nothing per task. Per the rubric guideline, missing validation in destructive/batch workflows caps this at 3.

3 / 5

Progressive Disclosure

The 345-line body has clean section headers but no reference files at all — everything is inline. In a skill well over 50 lines, content like the phase-by-phase breakdown, JSON format specifications, and troubleshooting clearly could live in separate reference files. This is anchor 3: reasonable structure, but content that should be separate is inline.

3 / 5

Total

13

/

20

Passed

Description

70%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 solid description with an explicit trigger clause and natural keywords, held back by a vague capability statement ('creation and management') that doesn't enumerate what the skill concretely does. Slight overlap risk with generic spec-writing requests.

Suggestions

Replace 'spec creation and management' with concrete capabilities, e.g. 'Creates feature specs (spec.md, requirements.json, implementation_plan.json) via the Auto-Claude spec pipeline'.

Add artifact and workflow synonyms as triggers, such as 'spec.md', 'specification', or 'implementation plan', to broaden natural-term coverage and sharpen distinctiveness.

Qualify triggers with the Auto-Claude context (e.g. 'when working with Auto-Claude builds') to reduce false triggers on generic spec-writing requests.

DimensionReasoningScore

Specificity

The description names the domain ('Auto-Claude spec creation and management') but the capability verbs are generic; the only concrete actions ('creating feature specs', 'modifying requirements') appear as trigger phrases rather than described capabilities. Fits anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several specific listed actions.

3 / 5

Completeness

An explicit 'Use when...' clause with four concrete triggers satisfies the 'when', and 'spec creation and management' provides a 'what' — but the 'what' is thin, not naming the artifacts produced (spec.md, requirements.json, implementation plan). Anchor 4 (both present, one could be more explicit) fits better than anchor 5.

4 / 5

Trigger Term Quality

Natural phrases like 'creating feature specs', 'spec pipeline phases', 'modifying requirements', and 'spec lifecycle' cover the domain well. Missing common synonyms such as 'specification' or artifact names like 'spec.md', so it falls just short of anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The Auto-Claude spec pipeline is a clear niche, but generic triggers like 'creating feature specs' or 'modifying requirements' could fire on ordinary spec-writing requests unrelated to the Auto-Claude tool. Minor overlap risk with general planning/writing skills puts this at anchor 4 rather than 5.

4 / 5

Total

15

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/auto-claude-spec/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.