skills/find-next-step/SKILL.md
Find the next unimplemented step in a phase. Use when determining what to work on next.
npx skillsauth add adamrdrew/ushabti find-next-stepInstall 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.
Run this command to see active phases and their next unimplemented step:
if [ -d .ushabti/phases ] && [ "$(ls -A .ushabti/phases 2>/dev/null)" ]; then
for dir in .ushabti/phases/*/; do
status=$(grep "^ status:" "$dir/progress.yaml" 2>/dev/null | awk '{print $2}')
if [ "$status" = "building" ] || [ "$status" = "planned" ]; then
name=$(basename "$dir")
next=$(awk '/- id:/{id=$3} /implemented: false/{print id; exit}' "$dir/progress.yaml" 2>/dev/null)
impl=$(grep -c "implemented: true" "$dir/progress.yaml" 2>/dev/null || echo 0)
total=$(grep -c "implemented:" "$dir/progress.yaml" 2>/dev/null || echo 0)
if [ -n "$next" ]; then
echo "$name: next step is $next ($impl/$total done)"
else
echo "$name: all steps implemented - ready for review"
fi
fi
done
else
echo "No active phases"
fi
In progress.yaml, each step has:
id: Step identifier (S001, S002, ...)implemented: false until Builder completes itreviewed: false until Overseer verifies itprogress.yaml to find first step with implemented: falsesteps.mdprogress.yaml: set implemented: true, add notes, list touched filesIf no steps have implemented: false, the phase is ready for review. Set phase.status: review in progress.yaml and hand off to Overseer.
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