workspace-calibration

Analyze Linear workspace health and usage patterns to surface structural, backlog, and hygiene issues.

16|3|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/breethomas/bette-think --skill workspace-calibration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-calibration
Source: https://github.com/breethomas/bette-think/tree/main/plugins/bette-think/skills/workspace-calibration
Command: npx skills add https://github.com/breethomas/bette-think --skill workspace-calibration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Help product managers quickly understand how a Linear workspace is organized and whether its teams, projects, backlogs, and workflows are healthy before starting prioritization or backlog work. This reduces wasted effort on misfiled issues, stale work, and confusing team structures when joining or auditing a workspace.

Core Features & Use Cases

  • Workspace discovery: Inventory teams, members, projects, cycles, labels, and statuses to reveal structure and naming patterns.
  • Health assessment: Measure backlog staleness, issue quality, project ownership/dates, cycle usage, triage activity, and workflow complexity against Linear best practices.
  • Calibration report: Produce a structured health report with green/yellow/red indicators, red flags, and prioritized recommendations to guide immediate and near-term cleanup.
  • Use case: Onboard a new PM by mapping teams and conventions so they know where to file work and what to prioritize.

Quick Start

Use workspace-calibration to analyze our Linear workspace and generate a health report for teams, backlogs, projects, cycles, labels, and workflows.

Frequently Asked Questions about workspace-calibration

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

FAQPage Schema
How do I check the health of a Linear workspace before starting backlog prioritization?

A Linear workspace health check inventories teams, projects, cycles, and labels, then assesses backlog staleness and workflow complexity. It produces a structured calibration report with green, yellow, and red indicators to guide immediate cleanup before prioritization.

What is the best way to audit Linear backlog staleness and issue quality?

Auditing Linear backlog staleness involves sampling up to 250 issues through MCP endpoints to evaluate issue quality and triage patterns. This reveals stale work and structural problems, producing a report with red flags and prioritized cleanup recommendations.

Can I use workspace-calibration to onboard a new PM to an existing Linear workspace?

Workspace-calibration supports onboarding a new PM by discovering Linear team structures, naming patterns, and project ownership. The generated calibration report highlights hygiene issues and red flags, helping the PM understand workspace conventions and prioritize backlog work.

Does the Linear workspace health check work with large teams and projects?

Yes, the health check scales across large Linear teams and projects by sampling 250 issues per MCP endpoint query. It evaluates cycle usage, label adoption, and triage activity across all teams, generating a calibration report with prioritized recommendations for near-term cleanup.

What Linear MCP endpoints are required to analyze workspace structure and workflows?

The required Linear MCP endpoints include list_teams, list_projects, list_issues, list_issue_labels, list_cycles, and list_issue_statuses. Sampling through these endpoints with a 250 limit reveals naming patterns, project ownership dates, and workflow complexity for the calibration report.

What are common red flags in a Linear workspace that indicate unhealthy backlog hygiene?

Unhealthy Linear backlog hygiene red flags include stale issues, misfiled work, inactive triage, and inconsistent label or cycle usage. The calibration report surfaces these structural issues with color-coded indicators and prioritized recommendations to reduce wasted effort during prioritization.