Project State Audit (wjs-auditing-project)
Runs a read-only, parallel audit of git, PRs, CI, releases, plan docs and logs, presents a grouped checklist, and fixes only what you explicitly confirm.
Dev & CodingIntermediate★ 123⑂ 18AI score 8/10Last updated: Aug 20, 2026
What it does
Answers "what's broken in this project?" / "why isn't my change shipped yet?" with one holistic sweep.
- Phase 1 (read-only, parallel):
git status/stash list/branch tracking, open & draft PRs viagh pr listplusgh pr checkson stale or non-clean PRs, failed GitHub Actions withgh run view --log-failed, commits since the last tag, iOSMARKETING_VERSION/CURRENT_PROJECT_VERSION, last fastlane invocation, plan drift againstTODOS.md/CHANGELOG.md/ROADMAP.md, TODO/FIXME markers, crash reports and runtime log errors. - Grouped checklist: 🔴 blocking / 🟡 open work / 🟢 plan drift / logs & errors / looks fine — each item states the problem, hard evidence (PR numbers, dates, paths) and a proposed yes/no action.
- Phase 2 (fix): only after explicit confirmation; ordered CI fixes → branch merges → tags → version bumps → release notes, re-verifying each check afterwards.
- Anything destructive or requiring signing (App Store submission,
git push --force,git reset --hard) is printed as a!-prefixed command for you to run, never executed for you.
Who it's for
- Developers returning to a project after time away
- Solo iOS developers on an Xcode + fastlane + TestFlight pipeline
- Anyone working through GitHub PRs/Actions who wants a recurring "what's stuck?" sweep
- Teams doing a pre-release dangling-work check
Example uses
- "Audit the project and tell me what's wrong" → checklist with 3 PRs failing CI, an unpushed local branch, 7 commits past the last tag, 2 overdue TODOS.md items.
- "Why isn't my in-app feedback live?" → traces the feedback PR, shows it auto-merged to main but no TestFlight build exists after the merge commit.
- "Fix just the red items" → reads failed CI logs, patches the root cause, pushes, re-runs the checks, and stops at
! fastlane pilot uploadfor you.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/jianshuo/claude-skills/HEAD/wjs-auditing-project/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the wjs-auditing-project folder from the GitHub repo jianshuo/claude-skills into my ~/.claude/skills/wjs-auditing-project/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/jianshuo/claude-skills.git /tmp/claude-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-skills/wjs-auditing-project ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the skills repo:
git clone https://github.com/jianshuo/claude-skills.git /tmp/claude-skills - Create the skills directory:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r /tmp/claude-skills/wjs-auditing-project ~/.claude/skills/ - Edit
~/.claude/skills/wjs-auditing-project/SKILL.mdand replace the author-specific parts: the/Users/jianshuo/code/Cathierpath, theCathierapp name, and the Xcode/fastlane steps. If you aren't shipping an iOS app, delete sections D and F or swap in your own release tooling. - Prerequisites: install
gitand the GitHub CLI, then authenticate withgh auth login(plus fastlane/Xcode if you keep the iOS checks). - Restart Claude Code and try: "audit this project and show me what's stalled."
View source on GitHub ↗License: MIT