faff-tidy

Grooms issue-tracker backlogs by detecting problems, applying mechanical fixes, and promoting ready issues.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faff-tidy-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faff-tidy
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faff-tidy
Command: npx skills add https://github.com/shftwst/faff --skill faff-tidy-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Backlogs accumulate duplicates, vague tickets, stale specs, dead blocker links, and orphaned issues over time, making it hard to know what is actually ready to build. This Skill audits the entire active backlog in one pass, fixes what is mechanically unambiguous, and surfaces what needs human judgement. ## Core Features & Use Cases - Two-direction grooming: finds the mess (dupes, vagueness, stale or superseded specs, dead references to cancelled work, dependency cycles, ghost-project pointers, chain gaps) while also promoting genuinely ready issues to Todo. - Acts, not just reports: mechanical fixes like stripping dead blocker links, repointing ghost containers, and demoting repeat-parked issues are applied automatically; judgement calls are surfaced for humans. - Structural diagnostics: detects dependency cycles, repeat-park patterns, splittable specs, and chain gaps where spec-implied work has no tracking ticket. - Use Case: Run it before a planning session to get a clean, ordered backlog: ready issues promoted and ranked, parked work surfaced with its blocking decision, and held work shown with reversibility and unlock-value signals. ## Quick Start Ask the agent to tidy the backlog and show which issues are ready to promote to Todo.

Frequently Asked Questions about faff-tidy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up a messy issue tracker backlog?▼

Run a tidy pass that re-fetches every active issue with its comments, classifies each into buckets (needs action, ready, almost ready, parked, on hold), and applies mechanical fixes like stripping dead blocker links. Judgement calls such as cancellations are surfaced for human decision, never auto-applied.

How to detect duplicate and stale tickets in a backlog?▼

The tidy pass flags duplicates covering the same work, stale specs whose design no longer matches the codebase, superseded specs whose premise was replaced by shipped work, and aging or dead-weight issues. Each finding comes with a recommended action such as merge, archive, or re-prep.

Can backlog grooming automatically promote issues to Todo?▼

Yes, but only issues with a real discoverable spec, no open blockers, and automation eligibility are promoted. Issues with only a description are never promoted; they are flagged for the prep skill instead, and eligibility labels are always human-gated.

What structural backlog problems can be detected automatically?▼

The diagnostics pass detects dependency cycles, ghost-project pointers to nonexistent containers, repeat-park patterns, splittable specs, and chain gaps where spec-implied work has no tracking ticket. Mechanical fixes like stripping defensive cycle edges are applied; the rest are surfaced.

Does the tidy skill change labels or cancel issues automatically?▼

No. Labelling is delegated to the prep skill, and tidy never suggests label changes. Cancelled work is ignored entirely, and descendants of cancelled ancestors are surfaced for human decision rather than auto-cancelled.