repo-intelligence-brief

Inspect a GitHub or local repository and produce a compact Codex-ready architecture/task brief. Use for repo onboarding, weekend project selection, fork analysis, setup discovery, extension ideas, or

SKILL.md

GitHub

Repo Intelligence Brief

Use this to turn a repo into a practical Codex work unit.

Intake

If the repo is remote, prefer a shallow clone into a bounded sources/ or vendor/ folder. Inspect before installing.

Run:

scripts/repo_snapshot.sh <repo>

Then read:

  • README and docs index
  • package manifests and lockfiles
  • entry points
  • tests and CI config
  • license

Output

# Repo Intelligence Brief

## What It Is
## Why It Matters
## Architecture
## Setup Commands
## Extension Points
## Useful Patterns To Steal
## Risks And Trust Notes
## First Three Codex Projects
## Smallest Valuable Build

Rules

  • Mark unverifiable trend claims as unverified.
  • Do not run install scripts until the source-intake safety pass is complete.
  • Keep the brief under 1200 words unless the user asks for deep research.
  • Prefer actionable project ideas over generic summaries.

Use $sandbox-source-intake first when a repo asks for broad permissions, downloads binaries, or has suspicious install instructions.

Validation

  • README, license, manifests, entry points, tests/CI, and docs index were checked when present.
  • Setup commands are marked inspect-only unless actually run.
  • Trend or popularity claims are verified or labeled unverified.