Primary finding
Undefined variables in templates (pct, owner, transition counts) make the spec incomplete/ambiguous
- skills/fleet-state/SKILL.md:201
- skills/fleet-state/SKILL.md:344
- skills/fleet-state/SKILL.md:174
- skills/fleet-state/SKILL.md:351-354
The article and notification refer to variables not defined elsewhere in the steps: pct (running percentage), owner (for spotlight fallback), and counts for transitions (N_LEVELED_UP, N_REVIVED, N_WENT_STALE, N_NEW_ACTIVE). Missing definitions create ambiguity for implementers and may lead to runtime placeholders leaking into output or inconsistent calculations.
Recommendation
- Define and compute pct explicitly (e.g., pct=$(( N_TOTAL>0 ? (100*N_RUNNING+N_TOTAL/2)/N_TOTAL : 0 )) with integer rounding) and note formatting to avoid divide-by-zero. - Define ${owner} or remove it from the fallback line; if it should be spotlight operator handle, specify how to extract it from SPOTLIGHT_FORK or history fields. - In Step 6, specify collecting counts for each transition category (and define variable names) alongside the bullet extraction. - Ensure all variables appearing in templates are defined in preceding steps.