Audits and fixes Shortcut projects to enforce best practices.
npx skills add https://github.com/fractionwork/pm-skills --skill shortcut-hygiene
Please help me install this Agent Skill. Skill: shortcut-hygiene Source: https://github.com/fractionwork/pm-skills/tree/main/skills/shortcut-hygiene Command: npx skills add https://github.com/fractionwork/pm-skills --skill shortcut-hygiene
Audit and fix a Shortcut project against Fraction best practices. Checks for missing Priority custom field, stories without estimates/owners/types, missing epics, vague titles, empty descriptions, workflow state coverage, and stale Inbox stories (>30 days). Field-strict checks (estimate / story_type / Priority / epic / Iteration) skip Inbox stories — those are deferred until Inbox → Unscheduled promotion. The owner check skips Inbox AND Unscheduled — both are intentionally unassigned per the three-tier rule (ownership lands at sprint planning when a story moves to Started+). Reports gaps with story name + permalink under each non-zero category and offers fixes. Can also enrich the backlog from meeting transcripts, emails, and chat. Always enforces all best practices by default — only skip checks if the user explicitly opts out. Triggers on "clean up shortcut", "audit shortcut project", "fix shortcut board", "standardize shortcut", "shortcut hygiene", "enrich shortcut backlog".
Run the Shortcut Hygiene skill against a project to generate a hygiene report and apply recommended fixes.
High-intent search queries and answers about installing and using this skill.
Auditing a Shortcut project involves checking stories against best practices for missing Priority fields, estimates, owners, types, and epic coverage. This skill reads your Shortcut project via MCP, generates a categorized gap report with story names and permalinks, and offers targeted fixes for each issue found.
Cleaning up stale Shortcut Inbox stories requires identifying items older than 30 days and ensuring they have clear titles and descriptions. This skill flags stale Inbox items during its hygiene audit while deferring strict field checks like estimates and ownership until promotion to Unscheduled states.
Standardizing Shortcut story titles and descriptions involves checking each story for vague naming and empty text fields. This skill audits your Shortcut project to identify stories with vague titles or empty descriptions and provides actionable fixes to enrich the backlog.
Yes, you can enrich your Shortcut backlog from meeting transcripts, emails, and chat. This skill parses those sources to create new stories while preserving source attribution and automatically enforcing default best practices like Priority fields, epic links, and clear descriptions.
Yes, a SHORTCUT_API_TOKEN is required to run a project audit. This token authenticates the REST operations in scripts/shortcut_ops.py that read project data, evaluate workflow state coverage, and apply fixes to your Shortcut board.
The hygiene audit skips owner checks for Unscheduled Shortcut stories because of a three-tier ownership rule where assignment lands at sprint planning. Stories require an owner when they move to the Started workflow state or higher, leaving Inbox and Unscheduled items intentionally unassigned.
AZANIRCreate and update Shortcut stories, epics, and iterations via REST API v3.
dmzoneillValidate and fix Jira issue fields and transition ready issues to refinement.
intelligent-alphaLog new opportunities with stable deal-ids and source attribution.
Partners-in-BizAudit ad creatives across platforms for compliance and creative fatigue.
