project-state-report

Generates a project catch-up report from git history and GitHub issue and PR activity.

1|Updated Aug 18, 2026
One-click install
npx skills add https://github.com/davidsneighbour/clerkwork --skill project-state-report-davidsneighbour
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-state-report
Source: https://github.com/davidsneighbour/clerkwork/tree/main/skills/project-state-report
Command: npx skills add https://github.com/davidsneighbour/clerkwork --skill project-state-report-davidsneighbour

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Returning to a repository after time away leaves you guessing what changed, which PRs merged, and what needs attention next. This Skill safely syncs remote state and produces a compact report of commits, GitHub activity, and a recommended next action. ## Core Features & Use Cases - Safe Remote Sync: Fetches and fast-forwards only when safe, classifying sync state as up to date, diverged, dirty-blocked, or failed without risking local work. - Change and Activity Summary: Resolves a since window from phrases like "yesterday" or "since we last worked", then summarizes commits, changed files, open issues, and PR activity via git and the GitHub CLI. - Next-Action Recommendation: Detects taskable items such as stale TODOs, PRs needing review, or failing checks, and recommends one primary action like triage, review, or validate. - Use Case: After a week away from a project, ask for a catch-up report and receive a summary of merged PRs, new issues, remote commits, and whether you should review PRs or start on a specific issue. ## Quick Start Use the project-state-report skill to refresh this repository and report what changed since last week.

Frequently Asked Questions about project-state-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I see what changed in a git repository since last week?▼

Run a project state report that resolves the date phrase to an absolute timestamp, fetches remote state, and summarizes commits, changed files, and GitHub activity in that window. It groups changes by area such as source, tests, docs, and dependencies.

How to catch up on a project after time away from the repo?▼

The report infers a baseline from your last authored commit or the pre-sync HEAD, fast-forwards the branch if safe, then lists remote commits, merged PRs, closed issues, and open work. It ends with one recommended next action.

Does this require the GitHub CLI to report issue and PR activity?▼

GitHub activity collection uses the gh CLI when available and authenticated. If GitHub data is unavailable, the report states that limitation and continues using local git evidence such as commit logs and diffs.

Will it pull remote changes if my working tree has uncommitted changes?▼

It only runs git pull --ff-only when the branch is strictly behind and the working tree is safe. If unrelated changes could be affected, it reports a dirty-blocked sync state instead of stashing or risking your work.

What happens when local and remote branches have diverged?▼

When both sides have unique commits, syncing stops and the report classifies the state as diverged. It compares both directions with commit ranges and recommends investigating rather than merging or rebasing automatically.