code-reading

Trace entry points and data flow to build codebase mental models.

14|7|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/aj-geddes/unicorn-team --skill code-reading-aj-geddes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-reading
Source: https://github.com/aj-geddes/unicorn-team/tree/main/skills/code-reading
Command: npx skills add https://github.com/aj-geddes/unicorn-team --skill code-reading-aj-geddes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guides engineers to understand unfamiliar codebases quickly by outlining a structured approach that forms accurate mental models of the code.

Core Features & Use Cases

  • Strategic entry-point discovery, data-flow tracing, and invariant identification to reduce guesswork during reviews.
  • Useful for onboarding to legacy systems, code reviews, and debugging complex issues.
  • Supports safer refactoring by documenting expected behavior and potential risk areas.

Quick Start

Describe the codebase by tracing entry points, data flow, and critical paths to build a mental model.

Frequently Asked Questions about code-reading

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

FAQPage Schema
What is the best way to understand an unfamiliar legacy codebase quickly?

To understand an unfamiliar legacy codebase quickly, use a structured reading protocol that traces strategic entry points, data flow, and critical paths to build an accurate mental model and reduce guesswork.

How do I trace data flow when debugging complex code issues?

Trace data flow during debugging by following data movement through entry points and integration points, documenting invariants to ensure reproducible understanding of complex code issues.

How can I plan safer refactoring for legacy code?

Plan safer refactoring for legacy code by documenting expected behavior, tracing data flow, and identifying potential risk areas to build a reliable mental model before modifying the system.

What should I look for during a code review to understand expected behavior?

During a code review, look for entry points, integration points, and invariants to understand expected behavior. This structured reading protocol reduces guesswork and forms accurate mental models of the code.

Can I use this code-reading approach for onboarding to new systems?

Yes, you can use this code-reading approach for onboarding to new systems. It guides developers through unfamiliar codebases by specifying a structured reading protocol to produce accurate mental models.