skills.rest
vvedantb
vvedantbCOMMUNITY
Explore all skills by this author →
Website𝕏@vvedantbGitHub

how

Explore code to produce architectural explanations of codebase subsystems.

99|6|Updated Jan 11, 2026
Search Tags:#architecture#onboarding#codebase#analysis#exploration#explain#senior-engineer
One-click install
npx skills add https://github.com/vvedantb/eva --skill how-vvedantb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: how
Source: https://github.com/vvedantb/eva/tree/main/.agents/skills/how
Command: npx skills add https://github.com/vvedantb/eva --skill how-vvedantb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Explains how a subsystem works by exploring code and producing a clear architectural explanation. Optionally critique the architecture for issues.

Core Features & Use Cases

  • Explain Mode (default): generates a concise architectural overview for a subsystem by tracing code paths and identifying key components.
  • Critique Mode: after the explanation, runs architectural critics to surface design weaknesses and improvement opportunities.
  • Structured Output: delivers Overview, Key Concepts, How It Works, Where Things Live, Gotchas.
  • Reference-first Discovery: uses frontmatter 'name' and 'description' for discovery and 'references/' prompts/reports to guide exploration.
  • Diagram Support: can include mermaid diagrams to visualize flows when helpful.

Quick Start

Ask a question about how a subsystem works and let the Skill generate a senior-engineering architectural explanation.

Frequently Asked Questions about how

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get an architectural overview of an unfamiliar codebase subsystem?▼

To get an architectural overview of a codebase subsystem, the Skill traces code paths and identifies key components to generate a concise explanation. It delivers a structured breakdown including an overview, key concepts, and data flows.

How can I identify architectural issues and design weaknesses during codebase exploration?▼

You can identify architectural issues during codebase exploration by using Critique Mode. After generating an architectural explanation, it runs architectural critics to surface design weaknesses and improvement opportunities.

Can I generate visual diagrams to visualize codebase data flows and architecture?▼

Yes, you can generate visual diagrams to visualize codebase data flows. The Skill includes diagram support and can automatically generate mermaid diagrams to visualize architectural flows when helpful.

What is the best way to explain how complex software architecture works to a new team?▼

The best way to explain how complex software architecture works is to produce a structured architectural summary. The Skill generates output covering Overview, Key Concepts, How It Works, Where Things Live, and Gotchas for clear team alignment.

Does the codebase analysis require specific dependencies or external tools to map architecture?▼

No specific dependencies or external tools are required to map architecture. The Skill uses reference-first discovery with internal frontmatter and references to guide exploration and produce the architectural explanation.

Related Skills

Explore More Software Engineering Skills→
workinprogress-aiworkinprogress-ai

devenv-chat-with-code

Explain codebase architecture with cited references to files and line numbers.

Official
Advanced
a7gardena7garden

pr-report

Analyze pull requests and generate maintainer-focused HTML or Markdown reports.

Community
Intermediate
prestariusprestarius
1

zoom-out

Explain unfamiliar code by mapping callers, dependencies, and subsystem boundaries.

Community
Intermediate
Liz2ZLiz2Z

biz-explainer

Extract business logic from codebases into Mermaid diagrams and documentation.

Community
Advanced