When should I use Spec Miner vs Architecture Designer?

Use Spec Miner to discover and document what currently exists in a codebase; use Architecture Designer to review and refine that discovered architecture for future changes.

How does Spec Miner handle uncertainty in code analysis?

The skill is constrained to distinguish between observed facts and inferences, and it includes a dedicated section in its output to flag uncertainties and questions for the user.

What is the primary goal of the Spec Miner skill?

Spec Miner is designed to analyze existing codebases and extract structured documentation and specifications, making it ideal for systems where documentation is missing or outdated.

Does Spec Miner make changes to my source code?

No, Spec Miner is a review-focused skill. It uses tools like Read, Grep, and Glob to observe and analyze your code without modifying the implementation.

What is the EARS format used by this skill?

EARS stands for Easy Approach to Requirements Syntax. It is a standardized template that Spec Miner uses to write clear, non-ambiguous requirements based on observed code behavior.

Spec Miner

Name: Spec Miner
Author: Jeffallan

byJeffallan

•

学習とドキュメンテーション

Extracts comprehensive specifications and documentation from existing codebases through systematic reverse-engineering.

Spec Miner transforms Claude Code into a senior software archaeologist specialized in documenting legacy systems and undocumented features. By utilizing a dual-perspective approach—Arch Hat for architecture and QA Hat for behavior—the skill explores source code using advanced search tools to trace data flows and map system structures. It produces high-fidelity specifications grounded in code evidence, using the EARS (Easy Approach to Requirements Syntax) format to ensure all observed requirements are clear, testable, and ready for refactoring or onboarding efforts.

主な機能

01Evidence-based code archaeology and pattern discovery

027 GitHub stars

03Comprehensive mapping of technology stacks and architectures

04Deep data flow and request path tracing using Grep and Glob

05Identification of undocumented edge cases and error handling

06Automated requirement extraction using the EARS format

ユースケース

01Generating technical documentation for undocumented legacy systems

02Extracting functional requirements before performing major refactors or migrations

03Rapidly onboarding developers to large or complex existing codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jeffallan/claude-skills spec-miner

For use in Claude.ai and ChatGPT

Download Skill