Claude
Skills
Sign in
Back

issue-audit

Included with Lifetime
$97 forever

Understand how a team organizes work in Linear. Helps PMs onboarding to new teams learn conventions, see examples, and know what questions to ask.

Security

What this skill does


# 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

1. Invokes the **team-organization-analyzer** agent with your team name
2. Agent fetches team structure: workflow states, labels, cycles
3. Samples 9 issues (3 active, 3 completed, 3 backlog)
4. 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*

Related in Security