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

75%

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

The body is actionability-forward with real commands, formats, and a clearly sequenced pipeline, but it is a monolithic ~350-line document that inlines material (templates, JSON schemas, troubleshooting, advanced usage) that belongs in one-level-deep reference files. The destructive delete and batch workflows lack validation steps, capping workflow clarity.

Suggestions

Add validation/verification steps before destructive and batch operations: before 'rm -rf .auto-claude/specs/...' or 'run.py --spec 001 --discard', check the spec status with 'run.py --list' and confirm it is not BUILDING; validate each spec after the batch-creation loop.

Move the spec.md template, requirements.json/implementation_plan.json formats, troubleshooting, and Advanced Usage sections into reference files (e.g., references/spec-formats.md, references/troubleshooting.md), leaving SKILL.md as a concise overview with clearly signaled links.

Trim explanatory padding such as the 'Specs are the foundation... They define:' overview list and the good/bad requirements examples, keeping only the decision-relevant complexity-selection table.

DimensionReasoningScore

Conciseness

Most content is tool-specific and concrete, but the body runs ~350 lines with unnecessary padding: "Specs are the foundation of Auto-Claude builds. They define: What needs to be built..." restates the obvious, and full templates (spec.md format, good/bad requirement examples, custom template heredoc, batch-creation shell loop) are inlined where a tighter core would do. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 4 because several sections are clearly trimmable to reference files.

3 / 5

Actionability

Concrete, copy-paste-ready commands appear throughout ("python spec_runner.py --interactive", "python spec_runner.py --task \"Add dark mode toggle to settings page\"", "python validate_spec.py --spec-dir ... --checkpoint all") along with complete JSON format examples, fitting 'mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because the working directory for spec_runner.py is ambiguous (only one example shows "cd apps/backend") and troubleshooting steps like the manual context-phase reset are only sketched in a comment.

4 / 5

Workflow Clarity

The pipeline is clearly sequenced (numbered phases 1-8 plus a complexity-to-phases table) and "Spec Review Tips" provides a pre-build checklist, but the destructive "Delete Spec" workflow ("rm -rf .auto-claude/specs/001-feature") and the batch spec-creation loop include no validation or verification steps. Per the rubric guideline, destructive/batch operations without validation cap workflow clarity at 3 even though the sequence alone would merit a 4.

3 / 5

Progressive Disclosure

Section headers give the body reasonable structure, but there are no bundle reference files at all: the full spec.md template, requirements.json and implementation_plan.json formats, troubleshooting, and advanced usage (custom prompts, batch creation, templates) are all inlined in a ~350-line document. This fits 'some structure but could be better organized; content that should be separate is inline'; the "Related Skills" links point to sibling skills, not reference files, so they do not improve the score.

3 / 5

Total

13

/

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: it explicitly states both what the skill does and when to use it, with concrete, domain-scoped trigger phrases. The main residual weaknesses are the generic word "management" and missing synonyms/variations (e.g., "specification", "write a spec") in the trigger terms.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("creating feature specs", "understanding spec pipeline phases", "modifying requirements", "managing spec lifecycle"), matching the 'several specific actions; minor gaps' anchor. It is not a 5 because "creation and management" is generic and capabilities the body covers (validating, listing, discarding specs) are omitted; it is above a 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

"Auto-Claude spec creation and management" explicitly answers what the skill does, and "Use when creating feature specs, understanding spec pipeline phases, modifying requirements, or managing spec lifecycle" is an explicit when-clause with four concrete trigger phrases, matching the top anchor. A 4 would require the when to be less specific, which it is not.

5 / 5

Trigger Term Quality

Natural phrases like "feature specs", "modifying requirements", and "spec lifecycle" match what a user of this tool would say, fitting 'good keyword coverage; a few natural terms missing'. Not a 5 because "spec pipeline phases" is internal jargon and synonyms such as "specification" or "write a spec" are absent; not a 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

The "Auto-Claude" scope plus niche triggers ("spec pipeline phases", "spec lifecycle") form a distinct domain with minor overlap risk, fitting 'mostly distinct; minor overlap risk with closely related skills'. Not a 5 because "creating feature specs" and "modifying requirements" could plausibly trigger generic requirements-writing or spec-authoring skills.

4 / 5

Total

17

/

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

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.