# Repo Radar

> Generate a compact repository briefing from manifests, workflows, docs, and source layout.

- Skill: `sahit-sai/repo-radar` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add sahit-sai/repo-radar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sahit-sai/repo-radar/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sahit-sai (https://skillmd.com/u/sahit-sai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sahit-sai/repo-radar

---


# repo-radar

## Purpose

Produce a fast onboarding brief for an unfamiliar codebase without making changes.

## Runbook

1. Run the skill at the repository root or a scoped subdirectory.
2. Use `scripts/brief.py` to inventory manifests, workflows, docs, tests, and dominant file types.
3. Read the generated brief before deeper exploration so you can choose the right next tool.
4. Treat the result as a map of likely hotspots, not as a substitute for targeted code review.

## Stop conditions

1. Abort if the repository tree is too incomplete to represent the project accurately.
2. Abort before drawing security or architecture conclusions from filename patterns alone.
3. Abort if the active variant cannot safely scan the requested directory.

## Output format

- Markdown or JSON repository briefing
- Detected manifests and workflow files
- Top file extensions and test coverage hints

## Example invocations

- `python3 skills/repo-radar/scripts/brief.py . --markdown`
- `python3 skills/repo-radar/scripts/brief.py services/backend`