skills.rest
BrendanShields
BrendanShieldsCOMMUNITY
Explore all skills by this author →
GitHub

spec:discover

Analyze codebases to generate project overview and technical landscape reports.

Updated Aug 23, 2026
Search Tags:#onboarding#refactoring#technical debt#codebase analysis#project discovery#architecture patterns#JIRA analysis
One-click install
npx skills add https://github.com/BrendanShields/spec-flow --skill spec-discover
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec:discover
Source: https://github.com/BrendanShields/spec-flow/tree/main/plugins/spec/.claude/skills/spec-discover
Command: npx skills add https://github.com/BrendanShields/spec-flow --skill spec-discover

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and examples (resource) components.

What problem does it solve?

Onboarding to a new project, planning refactoring, or assessing technical debt in an unfamiliar codebase can be time-consuming and complex. This Skill automates the deep analysis of existing codebases, providing comprehensive reports that accelerate understanding and decision-making for brownfield projects.

Core Features & Use Cases

  • Codebase Analysis: Discovers technology stack, architecture patterns, APIs, and data models.
  • Technical Debt Assessment: Identifies code quality issues, test coverage, complexity hotspots, and outdated dependencies.
  • JIRA Integration: Analyzes backlog, velocity, and sprint readiness (if configured via MCP).
  • Report Generation: Creates detailed reports like project-overview.md, technical-landscape.md, and backlog-analysis.md.
  • Use Case: A new team member can run spec:discover to get a full overview of a microservices project, including its tech stack, API endpoints, and key metrics, within minutes, significantly reducing onboarding time.

Quick Start

Use spec:discover to analyze the current codebase and generate a project overview report.