One-click install
npx skills add https://github.com/podcodar/webapp --skill explore-podcodar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: explore
Source: https://github.com/podcodar/webapp/tree/main/.agents/skills/explore
Command: npx skills add https://github.com/podcodar/webapp --skill explore-podcodar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of acting on incomplete or incorrect understanding of a codebase by providing a systematic way to research the project, locate relevant code paths, and validate assumptions before making changes.

Core Features & Use Cases

  • Project reconnaissance: Quickly reads key entry points (README, package metadata, agent instructions) and maps the directory structure and technology stack.
  • Architecture mapping: Identifies core modules and traces how a selected entity or data flows across layers (entry points to handlers to services to models/storage).
  • Targeted deep dives: Uses keyword searches, test discovery, and git history to understand specific features or bugs, including edge cases like validation, error handling, and authorization.

Quick Start

Use the explore skill to research the webapp repository so you can confidently explain how a given feature works and what you should change (or not change) before implementing improvements.

Frequently Asked Questions about explore

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

FAQPage Schema
How do I build accurate context before changing unfamiliar codebases?

To build accurate context before changing unfamiliar codebases, systematically research project entry points, trace data flows across modules, and validate assumptions using grep and git history. Documenting this outside-in analysis in a CONTEXT.md file ensures you act on verified understanding.

What is the best way to map architecture and trace data flow in a new repository?

Mapping architecture and tracing data flow involves identifying core modules and tracking a selected entity from entry points through handlers to services and storage. This targeted deep dive clarifies system behavior and responsibilities before you implement changes.

How do I investigate a bug in a codebase I do not fully understand?

Investigating a bug in an unfamiliar codebase requires targeted deep dives using keyword searches, test discovery, and git history. This evidence-based approach validates assumptions about edge cases like error handling and authorization before you attempt fixes.

Does this codebase exploration approach work for preparing code reviews?

Yes, codebase exploration works for preparing code reviews by providing a systematic way to research the project, locate relevant code paths, and validate assumptions. This ensures you understand the full impact of changes before reviewing them.

When do I need systematic codebase reconnaissance before implementing features?

You need systematic codebase reconnaissance when onboarding, planning features, or clarifying ambiguous behavior. Reading key entry points like README files and package metadata maps the directory structure and technology stack to prevent acting on incomplete understanding.

What are the limitations of mapping architecture without git history validation?

Mapping architecture without git history validation risks acting on incorrect understanding of specific features or bugs. Evidence-based validation via grep and git history is required to accurately clarify ambiguous behavior, edge cases, and authorization rules.