skills/approve-phase/SKILL.md
Approve a phase — sets status to complete, marks all steps reviewed, updates linked card. Use when declaring a phase green.
npx skillsauth add adamrdrew/ushabti approve-phaseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Single command to perform all mechanical state transitions when declaring a phase green:
complete in progress.yamlreviewed: true in progress.yamlcard: field, updates the card's status to done with current timestampYou still need to write your review decision in review.md separately — that's creative content this script doesn't touch.
python3 ${CLAUDE_PLUGIN_ROOT}/skills/approve-phase/approve-phase.py <phase-dir>
phase-dir: Path to the phase directory (e.g., .ushabti/phases/0005-my-phase)python3 ${CLAUDE_PLUGIN_ROOT}/skills/approve-phase/approve-phase.py .ushabti/phases/0009-tag-reconciler
# Output:
# Phase status: complete
# All steps: reviewed
# Card 'tag-reconciler': marked done
This replaces 4-5 separate Edit calls (status update + marking each step reviewed + card read + card update).
data-ai
Set the status field in a phase's progress.yaml. Use instead of manual Edit calls when transitioning phase status.
development
Query the status of a phase. Returns structured status information for external consumers.
data-ai
Mark a step as implemented in progress.yaml with notes and touched files. Use after completing each step instead of manual Edit calls.
testing
# List Cards Scan and list all Hieroglyphs-compatible cards in `.ushabti/cards/`, with optional filtering by status or other criteria. ## When to Use Use this skill when: - You need to see all available work items - Looking for cards in a specific state (e.g., only `todo` cards) - Determining which cards to plan next - Checking card priorities and types ## Card Location Cards are stored in: ``` .ushabti/cards/{slug}/card.md ``` Each card is a directory containing a `card.md` file with YAML