Skill

issue-audit

Audits Linear team issue organization: samples issues to analyze workflows, labels, cycles, writing patterns, and conventions. Helps PMs onboard by learning team practices.

developer-tools

npx claudepluginhub breethomas/bette-think --plugin bette-think

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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.

SKILL.md

Similar Skills

workspace-calibration

Analyzes Linear workspace health: teams, projects, issues, labels, and conventions. Delivers health indicators (green/yellow/red) as pre-flight check before backlog tasks.

2 files

bette-think

linear

17.6k

Manages issues, projects, and team workflows in Linear via MCP tools like list_issues, create_issue, update_issue. Useful for reading, creating, or updating tickets.

openai-skills-13

linear

586

Query and manage Linear issues, projects, and teams via bash CLI scripts. List issues, create new ones, update status/priority/assign, generate GitHub branches, daily standups.

1 file

sundial-org-awesome-openclaw-skills-4

Stats

Parent Repo Stars13

Parent Repo Forks2

Last CommitMar 8, 2026

Used By2 plugins

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

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