Skip to main content

SWE Repo Introspection

Skill Verified Active
Part of:Swe Skills

Inspects an unfamiliar software repository and produces a concrete orientation report covering structure, tooling, entry points, boundaries, active surfaces, and safe places to start work. Use when a user says `help me understand this repo`, `map this codebase before I edit it`, `where should I start`, or asks for an engineering walkthrough before planning or delegation. Do NOT use when the user already knows the target change and wants implementation, or when they need a specific bug diagnosis rather than repo orientation.

Purpose

To quickly orient engineers and agents in unfamiliar codebases, providing concrete evidence-based reports to guide development efforts.

Features

  • Generates repo structure maps
  • Identifies tooling and runtime shape
  • Locates entry points and boundaries
  • Captures validation and automation surfaces
  • Notes active and safe areas for editing

Use Cases

  • Understand an unfamiliar repository before editing it
  • Prepare for code delegation or planning
  • Map tooling, entry points, and boundaries
  • Find safe starting surfaces for follow-on work

Non-Goals

  • Implementing a known change request
  • Debugging a specific defect
  • Writing broad architecture visions beyond visible repo evidence

Workflow

  1. Inspect the root and primary docs
  2. Identify tooling and runtime shape
  3. Locate entry points and boundaries
  4. Capture validation and automation surfaces
  5. Note active and safe areas

Prerequisites

  • Local checkout and shell access
  • Standard repo inspection tools (e.g., fd, rg, git)
  • Access to repo docs or CI configuration

Installation

/plugin install swe-skills@ckorhonen-swe-skills

Quality Score

Verified
99 /100
Analyzed about 21 hours ago

Trust Signals

Last commit5 days ago
Stars1
LicenseMIT
Status
View Source

© 2025 SkillRepo · Find the right skill, skip the noise.