# Repo Status

> Read-only live repo snapshot: branch, upstream, working tree, stashes, recent commits, unpushed commits, and current user's open GitHub PRs. Use at session start, before delivery, or when repo state is unclear.

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

---


# Repo Status

Print a concise read-only snapshot of the current repository.

## Workflow

1. Run `python3 <skill-root>/scripts/repo_status.py` from the target repo.
2. Add `--full` when the user asks for more detail.
3. Do not run mutating commands: no fetch, pull, push, checkout, stash apply, or PR creation.
4. If `gh` is missing or unauthenticated, report the git state and say PR lookup was skipped.

## Output Rules

- Keep default output to one screen.
- Report facts, not remembered assumptions.
- Surface warnings for no upstream, behind upstream, unpushed commits, stashes, detached HEAD, and stale current-branch PRs.