Agent skill
project-health
Deep-dive health check on a single Linear project. Produces assessment with 7 dimensions - On Track / At Risk / Stalled.
Install this agent skill to your Project
npx add-skill https://github.com/breethomas/bette-think/tree/main/plugins/bette-think/skills/project-health
SKILL.md
Project Health Check
Analyze a single Linear project against execution best practices. Produces a health assessment: On Track / At Risk / Stalled.
Prerequisites
- Linear MCP must be configured
- Run
/linear-calibratefirst to identify projects worth investigating
Entry Point
When this skill is invoked, start with:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PROJECT HEALTH CHECK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Deep-dive health check on a specific Linear project.
Which project do you want to analyze?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Usage
/project-health [project-name]
Examples:
/project-health AI Video/project-health "HBN for Agent Customers"
What Happens
- Invokes the project-health-checker agent with your project name
- Agent fetches project details and all issues from Linear
- Applies 7 health dimensions with status-aware thresholds
- Generates structured health assessment
Health Dimensions
| Dimension | What It Measures |
|---|---|
| Ownership | Does the project have a lead assigned? |
| Timeline | Are start and target dates set? Is it overdue? |
| Progress | Completion percentage and recent activity |
| Scope Clarity | Description length (>300 chars = clear scope) |
| Issue Distribution | Right number of issues (5-100 is healthy) |
| Blockers | Percentage of open issues that are blocked |
| Staleness | Days since last activity |
Overall Rating
| Condition | Status |
|---|---|
| Any red dimension | Stalled |
| 2+ yellow (no red) | At Risk |
| 0-1 yellow | On Track |
After the Report
Options:
- Fix a specific red flag - I can help update the project
- See blocked issues - Detail on what's stuck
- Review issues missing descriptions - Quality cleanup
- Run on another project -
/project-health [other-name]
Relationship to Other Commands
/linear-calibrate → Workspace-level (flags "497 projects, 86% missing dates")
↓
/project-health [name] → THIS COMMAND - deep-dive on flagged projects
↓
/issue-audit [team] → Team workflow analysis
Part of PM Thought Partner Linear analysis suite
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
four-fits
Find which fit is broken before you burn cash scaling. Brian Balfour's framework for validating sustainable growth readiness.
prompt-engineering
Expert prompt optimization system for building production-ready AI features. Use when users request help improving prompts, want to create system prompts, need prompt review/critique, ask for prompt optimization strategies, want to analyze prompt effectiveness, mention prompt engineering best practices, request prompt templates, or need guidance on structuring AI instructions. Also use when users provide prompts and want suggestions for improvement.
strategy-session
Your product soundboard. Work through product decisions conversationally - Claude gathers context, challenges assumptions, captures decisions, and creates Linear issues.
ai-debug
Diagnose why an AI feature is underperforming, hallucinating, or behaving inconsistently. Uses 4D audit to work backwards from symptoms to root cause.
shape-up
Shape work using the Shape Up methodology (Ryan Singer, Basecamp). Walk through the 4-step shaping process to create pitches ready for betting. Distinguishes between established product mode (fixed time, variable scope) and new product mode (looser constraints). Use when planning cycle work, writing pitches, or coaching PMs on shaping.
competitive-research
Systematic competitive intelligence with parallel agent analysis. Analyzes competitors thoroughly and synthesizes into actionable insights.
Didn't find tool you were looking for?