project-health-check · qdhenry — Claude Code command: project analysis
project-health-check is a Claude Code command that reviews Git activity, dependencies, security findings, and Linear task metrics in a project health report. It helps identify risks to investigate.
no license ★ 1,357 updated 2026-03-01
.claude/commands/project-health-check.mdWhat project-health-check does
The command examines Git changes and contributor activity, branch status, test coverage, dependencies, and vulnerabilities. Its checks can use cloc, npm test, npm outdated, npm audit, and npx license-checker. The report groups findings across delivery, code quality, technical debt, team indicators, and dependencies, then outlines risks and potential actions.
Task metrics rely on Linear, while repository checks cover Git and GitHub. Without a Linear connection, sprint velocity and task data need manual input; the analysis is limited to Git/GitHub metrics. You can adjust the evaluation period and thresholds. The documented default period is the last 30 days.
What it helps with
- review Git change patterns and contributor activity
- find outdated packages and dependency vulnerabilities
- compare sprint velocity with task cycle times
- turn project risks into a list of follow-up actions
Example prompts for the agent
- Check project health for the last 30 days and write a report.
- Review dependencies and security issues, then list the project risks.
- Analyze the project metrics and suggest actions for the problems you find.
How to install project-health-check
Manually: put the files in place
.claude/commands/project-health-check.mdCall it with /project-health-check. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/project-health-check.mdCall it with /prompts:project-health-check. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/project-health-check.prompt.mdManually: put the files in place
.gemini/commands/project-health-check.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about project-health-check
How do I install project-health-check in Claude Code?
Add the command file at .claude/commands/project-health-check.md.
What does project-health-check do?
It reviews code, dependency, and task indicators, then produces a report with risks and suggested actions.
Does the command require Linear?
No. Git and GitHub checks can still run, but sprint and task metrics require manual input when Linear is not connected.
Similar slash commands
Slash commands catalog →project-health-check by other authors comes first.