familiarize

Analyze repository files, documentation, and git history to map codebase structure and workflows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/olliecrow/codex --skill familiarize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: familiarize
Source: https://github.com/olliecrow/codex/tree/main/skills/familiarize
Command: npx skills add https://github.com/olliecrow/codex --skill familiarize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you rapidly understand the structure, purpose, and workflows of any codebase, enabling faster onboarding and more informed development decisions.

Core Features & Use Cases

  • Codebase Mapping: Visualize the repository's layout, key directories, and entry points.
  • Workflow Identification: Document build, run, and test commands, along with configuration and environment needs.
  • Change Assessment: Compare current branch changes against the main branch to understand divergence.
  • Use Case: When you're assigned to a new project, use this Skill to get a comprehensive overview of the architecture and current development status within minutes.

Quick Start

Use the familiarize skill to map out the structure and workflows of the current repository.

Frequently Asked Questions about familiarize

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

FAQPage Schema
How do I quickly understand a new codebase for developer onboarding?

To understand a new codebase for developer onboarding, you can explore the repository's files, documentation, and git history. This process maps the repository layout, identifies entry points, and documents build and test workflows.

What's the best way to summarize software architecture from a repository exploration?

Summarizing software architecture from a repository exploration involves analyzing key directories and configuration files. This read-only analysis identifies the project's purpose, structural layout, and core workflow commands.

How do I assess current branch changes against the main branch?

Assessing current branch changes against the main branch requires comparing the git diff. This change assessment highlights divergence from the main branch, clarifying the current development status and recent modifications.

Can I identify build and test commands through codebase analysis?

Codebase analysis can identify build and test commands by reading repository documentation and configuration files. This workflow identification documents the necessary environment setup and execution commands for the project.

Does this codebase familiarization approach require write access to the repository?

This codebase familiarization approach requires read-only access to the repository. It relies exclusively on exploring and analyzing repository files, documentation, and git history without modifying the existing codebase.

When do I need codebase mapping for repository exploration?

You need codebase mapping for repository exploration when assigned to a new project. It provides a comprehensive overview of the architecture and development status within minutes, enabling faster orientation and informed decisions.