CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-spec-parser

Parse and validate project specifications. Use when loading YAML/JSON specs, validating spec structure, extracting requirements, or converting between spec formats.

Quality

84%

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

The canonical home for this skill is ac-spec-parser in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, well-structured body with executable quick-start code against the real bundle script, an explicit validation checkpoint, and clean one-level-deep disclosure. The main improvement opportunities are a small amount of redundant framing text and the absence of failure-path guidance in the workflow.

Suggestions

Remove the 'Purpose' section (or the intro line under the title) — they restate the frontmatter description; keep the one sentence that adds new information about downstream use.

Add a brief failure-path note to the workflow (e.g., 'If validation fails, report the missing field/invalid value and stop before exporting'), turning the Validate step into a true feedback checkpoint.

Make the Quick Start copy-paste ready by defining the input (e.g., project_dir = Path('.') and noting the parse call is async) so the snippet runs as written.

DimensionReasoningScore

Conciseness

The body is tight — no concept explanations Claude already knows, and the 28-line schema example is core content, not padding. The one trimmable redundancy is the intro line plus 'Purpose' section restating the frontmatter description, which fits anchor 4's 'minor instances of over-explanation that could be trimmed' rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

The Quick Start is real executable Python importing the actual bundle module ('from scripts.spec_parser import SpecParser', and scripts/spec_parser.py exists), backed by a concrete schema example and explicit validation rules. It falls short of anchor 5 because the snippet has minor gaps — 'project_dir' is undefined, the 'await' lacks its async context, and only the happy path is shown — but it is well above anchor 3's pseudocode level.

4 / 5

Workflow Clarity

The five-step sequence (Load, Parse, Validate, Normalize, Export) is clearly ordered, and validation is an explicit step backed by a dedicated 'Validation Rules' section with five concrete rules, satisfying anchor 4's 'most checkpoints present'. It is not anchor 5 because there is no error-recovery feedback loop (what to do when validation fails), though spec parsing is non-destructive so the batch/destructive cap at 3 does not apply.

4 / 5

Progressive Disclosure

SKILL.md is a well-organized overview whose only external reference ('See scripts/spec_parser.py for full implementation') is clearly signaled, one level deep, and points to a real bundle file. Content is appropriately split — API bulk lives in the script, the essential schema stays inline — with no inlined material that belongs in a separate file and no nested references, matching anchor 5.

5 / 5

Total

17

/

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 with a clear what-and-when structure and concrete trigger phrases modeled on best practice. Its only weaknesses are small coverage gaps: no file extensions or Markdown mention in the triggers, and the normalize step is unlisted.

DimensionReasoningScore

Specificity

The lead sentence names two concrete actions ('Parse and validate project specifications') and the trigger clause adds more ('loading YAML/JSON specs, validating spec structure, extracting requirements, or converting between spec formats'). This is several specific actions with minor gaps — normalize/export from the body workflow are absent — so it matches anchor 4 rather than anchor 5's comprehensive coverage, and clearly exceeds anchor 3's 1-2 actions.

4 / 5

Completeness

It explicitly answers both: what ('Parse and validate project specifications') and when ('Use when loading YAML/JSON specs, validating spec structure, extracting requirements, or converting between spec formats') with four concrete trigger activities. This mirrors the anchor-5 example structure; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural terms users would say are present: 'loading YAML/JSON specs', 'validating spec structure', 'extracting requirements', 'converting between spec formats'. A few natural terms are missing — file extensions (.yaml, .yml, .json), 'spec files' phrasing, and any mention of Markdown specs despite the body supporting .md — so it fits anchor 4's 'good keyword coverage; a few natural terms missing' rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — parsing project specification files for the autonomous-coding pipeline — with distinct triggers around spec structure and spec formats. Minor overlap risk remains with generic YAML/JSON manipulation or requirements-analysis skills, matching anchor 4 ('mostly distinct; minor overlap risk') rather than anchor 5's minimal-conflict profile.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fernandezbaptiste/Skrillz

Path

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