project-status

Project status

Cold-start orientation skill. Run when you sit down on a project after being away and want a quick read on what's live, what's in flight, what's stale, and what needs your attention before you start coding.

This is a read-only skill. No commits, no merges, no deploys, no file writes. Just inspection + synthesis.

Step 1: Detect project context

Determine which project this is. Order:

1. If cwd is inside a git repo: project = repo basename. REPO_ROOT=$(git rev-parse --show-toplevel).
2. If cwd is inside ~/.claude/projects/<X>/: project = <X>. No repo unless one is linked.
3. Otherwise: bail with "Run from a project directory (git repo or ~/.claude/projects//)."

Locate the project's CLAUDE.md (in priority order):

1. Repo-root CLAUDE.md
2. ~/.claude/projects/<project>/CLAUDE.md
3. ~/.claude/projects/<other-naming-variant>/CLAUDE.md (e.g. Python-Project-<X>)

State the detected project + CLAUDE.md path in the first line of the report.

Step 2: Gather data (run in parallel where possible)

2a. Git state (always)

git rev-parse --abbrev-ref HEAD          # current branch
git status --porcelain | wc -l           # dirty file count
git log -1 --format='%h %s (%cr)'        # last commit, age
git rev-list --left-right --count HEAD...main 2>/dev/null  # ahead/behind main

2b. Open PRs against main (needs REPO_ROOT and an authed gh CLI)

cd "$REPO_ROOT" && gh pr list --base main --state open --json number,title,headRefName,isDraft,createdAt,mergeable 2>/dev/null

For each PR, compute age in days. Flag PRs older than 14 days as stale.

The cd "$REPO_ROOT" is load-bearing. This skill is often launched from a project data directory that sits inside a different git repository, so a bare gh resolves to THAT repository and returns [] no matter what the project has open. It is a truthful answer about the wrong repo, which is the worst kind. gh -R <owner>/<repo> is equally fine. When step 1 found no REPO_ROOT, skip this section and report it as skipped, never as zero: an empty result here is a false negative, not a clean bill.