spec-miner
tessl i github:jeffallan/claude-skills --skill spec-minerUse when understanding legacy or undocumented systems, creating documentation for existing code, or extracting specifications from implementations. Invoke for legacy analysis, code archaeology, undocumented features.
Review Score
63%
Validation Score
11/16
Implementation Score
57%
Activation Score
N/A
Generated
Validation
Total
11/16Score
Passed| Criteria | Score |
|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) |
metadata_version | 'metadata' field is not a dictionary |
license_field | 'license' field is missing |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata |
body_examples | No examples detected (no code fences and no 'Example' wording) |
Implementation
Suggestions 4
Score
57%Overall Assessment
This skill has strong organizational structure with good progressive disclosure through its reference table, but lacks the concrete, executable guidance needed for high actionability. The workflow is present but missing validation checkpoints, and some content (role definition, knowledge reference) adds tokens without adding value Claude doesn't already have.
Suggestions
- Add concrete Glob/Grep pattern examples directly in the skill (e.g., `Grep('TODO|FIXME|HACK', include='*.py')` for finding technical debt)
- Include a brief inline EARS format example rather than only referencing external file (e.g., 'When [condition], the system shall [action]')
- Add a validation checkpoint after the Trace step to verify data flow coverage before documenting
- Remove or condense the 'Knowledge Reference' section as it lists concepts Claude already understands
| Dimension | Score | Reasoning |
|---|---|---|
Conciseness | 2/3 | Generally efficient but includes some unnecessary framing ('senior software archaeologist with 10+ years of experience') and the 'Knowledge Reference' section lists concepts Claude already knows without adding value. |
Actionability | 2/3 | Provides a clear workflow and constraints but lacks concrete examples of Glob/Grep patterns, actual EARS format syntax, or executable commands. The guidance is directional rather than copy-paste ready. |
Workflow Clarity | 2/3 | The 5-step workflow is clearly sequenced, but lacks validation checkpoints or feedback loops. No explicit verification step to confirm analysis completeness before documenting, and the 'Flag' step is vague. |
Progressive Disclosure | 3/3 | Excellent structure with a clear overview and well-organized reference table pointing to one-level-deep external files. The table format makes navigation easy and signals when to load each reference. |
Activation
Score
N/ASomething went wrong
- Repository
- github.com/jeffallan/claude-skills
- Last updated
- Created
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.