project-health

Assesses and scores software project health across five operational dimensions using Git, npm, and optionally task tools.

5|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/SteveFeldman/agents-skills --skill project-health-stevefeldman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-health
Source: https://github.com/SteveFeldman/agents-skills/tree/main/skills/project-health
Command: npx skills add https://github.com/SteveFeldman/agents-skills --skill project-health-stevefeldman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive, multi-dimensional assessment of a software project's health, identifying risks and areas for improvement across key operational dimensions.

Core Features & Use Cases

  • Automated Metric Collection: Gathers data from Git, package managers, and optionally task management tools.
  • Scored Dashboard: Presents a clear, scored overview of Delivery, Quality, Debt, Team, and Dependency health.
  • Trend Analysis: Visualizes historical performance to identify improvements or regressions.
  • Risk Assessment & Recommendations: Highlights critical risks and suggests actionable steps.
  • Use Case: A team lead can run this skill at the start of each sprint to get an objective view of project status, identify bottlenecks in the delivery pipeline, and proactively address code quality issues before they escalate.

Quick Start

Run the project-health skill to generate a comprehensive report for the current project.

Frequently Asked Questions about project-health

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

FAQPage Schema
How do I assess software project health and track technical debt?

Assessing project health involves scoring delivery, quality, debt, team, and dependency metrics. This Skill collects data from Git and package managers to provide trend analysis and risk assessment for software development projects.

Can I measure team performance and delivery metrics using Git history?

Yes, measuring team performance and delivery metrics uses Git history alongside package managers. It optionally integrates with Linear or GitHub Projects to score team health and identify bottlenecks in the delivery pipeline.

Do I need a task management tool to calculate code quality and dependency management scores?

A task management tool is optional for calculating code quality and dependency scores. The Skill requires Git and package managers like npm or pip for full functionality, while Linear or GitHub Projects enhance team metrics.

What is the best way to automate technical debt risk assessment for a development sprint?

Automating technical debt risk assessment requires gathering data from Git and package managers. This Skill generates a scored dashboard highlighting critical risks and actionable recommendations to run at the start of each sprint.

How does trend analysis for code quality and dependency management work?

Trend analysis for code quality works by visualizing historical performance data collected from Git and package managers. It identifies improvements or regressions across multiple project health dimensions over time.