proflead/codex-skills-library / skills/foundation/codebase-orientation
codebase-orientation
UnverifiedGuide quick orientation of an unfamiliar codebase with module mapping, entry points, and local run steps. Use when a junior developer needs to get situated fast.
Codebase Orientation
Purpose
Guide quick orientation of an unfamiliar codebase with module mapping, entry points, and local run steps.
Inputs to request
- Repo URL or local path and target area of interest.
- Runtime versions, package manager, and OS.
- Current task or reason for onboarding.
Workflow
- Locate entry points, build scripts, and main runtime paths.
- Map key folders, ownership, and common naming conventions.
- Identify how to run, test, and debug locally with minimal setup.
- Call out one or two safe starter tasks for learning.
Output
- High-level module map with file paths.
- Local run/test commands with prerequisites.
- Suggested first change with low risk.
Quality bar
- Reference concrete file paths and commands.
- Keep scope limited to the requested area.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |