Skills
Source

Skill

review-workspace

Skeptical pre-push review of local git changes — catches shippability issues before the PR. Session under .agents/artifacts/.../review-workspace/ when gitignored, else ~/.agents/artifacts/ (see `<SKILL_DIR>/scripts/artifacts.sh` allocate).

Compatibility: Requires a git repository.

Install this skill

npx skills add adiutama/skills --skill review-workspace

Invoked as /review-workspace [target-branch-or-commit-sha].

Step 1 — Gather git state

TARGET = arg 1 (optional), default HEAD.

Run once: bash <SKILL_DIR>/scripts/resolve-range.sh "<TARGET>".

Expected keys: BRANCH, HEAD_SHA, TARGET_SHA, PR_BASE, RANGE_BASE, COMMITTED_RANGE, INCLUDE_UNCOMMITTED.

If non-zero exit, stop and return error as-is.

Use COMMITTED_RANGE as committed scope (parent+1..target).

Run in parallel:

  • git diff <COMMITTED_RANGE>
  • git status --short

If INCLUDE_UNCOMMITTED=1, also run git diff HEAD.

Review surface = committed diff + optional uncommitted diff. If empty, print:

Nothing to review — no relevant changes in <COMMITTED_RANGE> and no uncommitted modifications.

Then stop.

Step 2 — Session path

Run bash <SKILL_DIR>/scripts/artifacts.sh allocate review-workspace [branch] (optional branch; default current HEAD). Parse KEY=VALUE output: OWNER, REPO, BRANCH, BRANCH_SLUG, SESSION_DIR, SESSION_PATH, PASS, WRITE_ROOT, WRITE_SCOPE.

Write root is gitignore-gated: when <git-root>/.agents/artifacts (or .agents) is ignored, artifacts stay project-local (WRITE_SCOPE=local); otherwise writes use ~/.agents/artifacts (WRITE_SCOPE=global). Override with AGENTS_ARTIFACTS_SCOPE=local|global.

Step 3 — Load context (parallel)

  • <SKILL_DIR>/references/checklist.md
  • <SKILL_DIR>/references/format.md
  • <SKILL_DIR>/references/output-contract.md
  • <SKILL_DIR>/assets/template.md
  • Pass 02+: previous session file (<NN-1>.md)
  • Repo root docs: AGENTS.md or CLAUDE.md; fallback README.md
  • Target repo docs/ files relevant to touched areas

Repo root discovery order:

  1. .git in workspace
  2. .git in immediate child
  3. .git in sibling
  4. .git in parent

Stop at first match. Skip silently if docs are missing.

Step 4 — Write the review

Follow checklist.md (workflow/coverage), format.md (structure/tags/summary), output-contract.md (guarantees), and assets/template.md (skeleton).

Save to SESSION_PATH. Posture: skeptical, curious, ambitious.

Step 5 — Print summary

Print summary using format.md output summary format, then stop.

skills/review-workspace/SKILL.md