skills/mark-step-done/SKILL.md
Mark a step as implemented in progress.yaml with notes and touched files. Use after completing each step instead of manual Edit calls.
npx skillsauth add adamrdrew/ushabti mark-step-doneInstall 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.
Updates a step entry in progress.yaml to set implemented: true, and optionally sets notes and touched file list. Handles both touched and files field names.
python3 ${CLAUDE_PLUGIN_ROOT}/skills/mark-step-done/mark-step-done.py <phase-dir> <step-id> [--notes "..."] [--files file1 file2 ...]
phase-dir: Path to the phase directorystep-id: The step ID to mark done (e.g., S001 or 1)--notes: Optional description of what was done--files: Optional list of files touched by this step# Simple completion
python3 ${CLAUDE_PLUGIN_ROOT}/skills/mark-step-done/mark-step-done.py .ushabti/phases/0005-my-phase S001 --notes "Protocol defined" --files src/protocol.ts src/types.ts
# Without notes or files
python3 ${CLAUDE_PLUGIN_ROOT}/skills/mark-step-done/mark-step-done.py .ushabti/phases/0005-my-phase S002
This replaces the manual read-edit-write cycle on progress.yaml after each step.
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.
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
development
Kick a phase back to building — sets status and adds new step entries to progress.yaml. Use when requesting fixes from Builder.