| name | issue-audit |
| description | Understand how a team organizes work in Linear. Helps PMs onboarding to new teams learn conventions, see examples, and know what questions to ask. |
Issue Audit
Understand how a team organizes and writes issues in Linear. Helps PMs onboarding to new teams learn conventions, see examples, and know what questions to ask.
Prerequisites
- Linear MCP must be configured
Entry Point
When this skill is invoked, start with:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ISSUE AUDIT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Learn how a team organizes work in Linear.
Helps you onboard faster and follow team conventions.
Which team do you want to analyze?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Usage
/issue-audit [team name]
Examples:
/issue-audit Customer Experience/issue-audit Platform/issue-audit "Data Engineering"
What Happens
- Invokes the team-organization-analyzer agent with your team name
- Agent fetches team structure: workflow states, labels, cycles
- Samples 9 issues (3 active, 3 completed, 3 backlog)
- Analyzes patterns and infers conventions
What You'll Learn
- Workflow: How issues flow through states (Triage -> Done)
- Labels: What taxonomy the team uses (Type, Area, Priority)
- Cycles: Whether they use sprints and cadence
- Patterns: How they write issues (descriptions, titles, hierarchy)
- Conventions: What a new PM should follow
Sample Size Philosophy
9 issues is intentional - enough to observe patterns without overwhelming. The agent:
- Won't apologize for limited data
- Reports specific observations ("5 of 9 have descriptions")
- Infers conventions from patterns
- Offers concrete drill-down prompts
After the Report
Explore further:
- "Show me issue [ID]" - Full details on any sample
- "Show me 3 parent issues" - See epic structure
- "Show me issues labeled [X]" - Filter by label
- "Run /issue-audit on [other team]" - Compare patterns
Relationship to Other Commands
/linear-calibrate → Workspace-wide health (30,000 ft view)
↓
┌────┴────┐
↓ ↓
/project-health /issue-audit
[project] [team]
(execution health) (organization patterns) ← THIS COMMAND
/linear-calibrate flags workspace-level issues/project-health checks if a specific project is on track/issue-audit helps PM understand how a team works
Part of PM Thought Partner Linear analysis suite
