asana-hygiene

Audit Asana projects and auto-fix hygiene issues per Fraction best practices.

Updated May 8, 2026
One-click install
npx skills add https://github.com/fractionwork/pm-skills --skill asana-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asana-hygiene
Source: https://github.com/fractionwork/pm-skills/tree/main/skills/asana-hygiene
Command: npx skills add https://github.com/fractionwork/pm-skills --skill asana-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Audit and fix an Asana project against Fraction best practices. Checks for missing custom fields (including Release enum), orphaned tasks, incomplete metadata, missing admins, unestimated stories, missing release tags, vague titles, empty descriptions, non-standard sections, and stale INBOX items (>30 days). Field-strict checks (Priority/Type/Points/Release) skip INBOX — those are deferred until INBOX → BACKLOG promotion. Fixes issues automatically and reports what needs manual attention. 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 asana", "audit project", "fix asana board", "standardize project", "asana hygiene", "enrich backlog", or any request to bring an Asana project into compliance.

Core Features & Use Cases

  • Audit and fix a project against standard hygiene rules, including fields, sections, admins, and owners.
  • Auto-fix common issues (e.g., missing custom fields, orphaned tasks, vague titles) and provide clear guidance for manual follow-up.
  • Enrich backlog with context from meetings, emails, or chats, while preserving source attribution.

Quick Start

Run the hygiene script against your Asana project to audit and fix issues per Fraction standards.

Frequently Asked Questions about asana-hygiene

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

FAQPage Schema
How do I clean up an Asana project and fix backlog hygiene issues?

To clean up an Asana project, this hygiene audit checks for missing custom fields, orphaned tasks, and incomplete metadata, then automatically fixes issues or provides manual guidance per best practices. It ensures projects stay compliant by enforcing standard fields and sections.

What is the best way to standardize Asana sections and custom fields automatically?

Standardizing Asana sections and custom fields is handled by auditing the project against Fraction best practices. The script automatically fixes non-standard sections, missing Release tags, and field-strict checks for Priority, Type, Points, and Release.

Can I use Asana REST API to manage INBOX to BACKLOG transitions?

Yes, managing INBOX to BACKLOG transitions is supported via REST calls. The script handles INBOX, BACKLOG, and TODO sections, automatically transitioning stale INBOX items older than 30 days and enforcing field-strict checks upon promotion.

How do I enrich Asana backlog from meeting transcripts and chat?

Enriching an Asana backlog from meeting transcripts, emails, and chats uses source attribution to maintain context. The script processes external sources to populate the backlog while preserving the origin metadata of the imported tasks.

Why are field-strict checks skipped for INBOX tasks in Asana?

Field-strict checks for Priority, Type, Points, and Release are skipped for INBOX tasks because these requirements are deferred until promotion. This prevents enforcing full metadata compliance on unsorted items before they transition to BACKLOG.

Does the Asana hygiene audit require the requests library?

Yes, the Asana hygiene audit requires the requests library to execute REST calls. These calls manage tasks, sections, and custom fields to automatically correct missing admins, vague titles, and empty descriptions.