Spec Miner
When you inherit a codebase with zero documentation or need to understand what legacy code actually does, this skill systematically reverse engineers it into proper specs. It uses a two-perspective approach (architecture and QA) to map dependencies, trace data flows, and extract observable behaviors using Read, Grep, and Glob tools. The output is EARS-format requirements grounded in actual code evidence, saved as structured specification documents. The built-in validation checkpoints are smart: it won't let you write docs until you've actually read enough files to understand what's going on. Best for code archaeology situations where you need to document first, then modify.
- skills.sh installs
- 4.7K
- GitHub stars
- 12.3K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add jeffallan/claude-skills --skill spec-miner --agent claude-codeInstalls into .claude/skills of the current project.
Files
Spec Miner
Reverse-engineering specialist who extracts specifications from existing codebases.
Role Definition
You operate with two perspectives: Arch Hat for system architecture and data flows, and QA Hat for observable behaviors and edge cases.
When to Use This Skill
- Understanding legacy or undocumented systems
- Creating documentation for existing code
- Onboarding to a new codebase
- Planning enhancements to existing features
- Extracting requirements from implementation
Core Workflow
- Scope - Identify analysis boundaries (full system or specific feature)
- Explore - Map structure using Glob, Grep, Read tools
- Validation checkpoint: Confirm sufficient file coverage before proceeding. If key entry points, configuration files, or core modules remain unread, continue exploration before writing documentation.
- Trace - Follow data flows and request paths
- Document - Write observed requirements in EARS format
- Flag - Mark areas needing clarification
Example Exploration Patterns
# Find entry points and public interfaces
Glob('**/*.py', exclude=['**/test*', '**/__pycache__/**'])
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/jeffallan/claude-skills
- Categories
- Backend & APIs, Documentation, Code Review & Quality
More from jeffallan/claude-skills
All 66- The Fool4.7K
- Atlassian Mcp4.6K
- Legacy Modernizer4.6K
- Salesforce Developer4.5K
- Feature Forge4.5K
- Fine Tuning Expert4.5K
- Django Expert4.5K
- Mcp Developer4.4K
- Swift Expert4.4K
- Vue Expert Js4.3K
- Graphql Architect4.3K
- Chaos Engineer4.3K
- Ml Pipeline4.1K
- Spark Engineer4.1K
- Laravel Specialist23.9K
- Golang Pro19.5K
- Php Pro16.1K
- Flutter Expert14.7K
- Typescript Pro14.6K
- Kubernetes Specialist14.6K
- Devops Engineer11.9K
- Wordpress Pro10.2K
- Python Pro9.1K
- Spring Boot Engineer8.7K
Recommended
More Backend & APIs
mobile-platform-offline-validateforcedotcom/sf-skillsReview a Lightning Web Component for **mobile offline** compatibility — the Komaci offline static analyzer that pre-primes the data graph for Salesforce Mobile 4.7Kskills.sh installs
uitw93/wazaProduces distinctive, production-grade UI for pages, components, visual interfaces, typography, and screenshot-driven polish. Use when users ask in any language4.7Kskills.sh installs
iii-architecture-patternsiii-hq/iiiUse when composing iii primitives into backend architectures: durable workflows, reactive backends, agentic pipelines, event-driven CQRS, effect pipelines, and 4.7Kskills.sh installsiii-core-primitivesiii-hq/iiiUse when registering iii functions, binding triggers, selecting sync/void/enqueue invocation, creating workers, inspecting the live worker registry, installing 4.7Kskills.sh installs
code-testing-agentdotnet/skillsMANDATORY ENTRY POINT for generating or writing tests. Invoke this skill before editing files whenever the user asks to generate tests, write/add unit tests, sc4.7Kskills.sh installs
yahoo-financegracefullight/stock-checkerGet stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.4.7Kskills.sh installs