project-health

Inspect repository structure and run build, lint, and test checks.

Updated Oct 12, 2025
One-click install
npx skills add https://github.com/IDEA-on-Action/IDEA-on-Action --skill project-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-health
Source: https://github.com/IDEA-on-Action/IDEA-on-Action/tree/main/.claude/skills/project-health
Command: npx skills add https://github.com/IDEA-on-Action/IDEA-on-Action --skill project-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

프로젝트 상태를 빠르게 진단하고, 빌드, 린트, 버전 동기화 등 핵심 지표를 점검해 실패를 예방한다.

Core Features & Use Cases

  • SDD/구조 점검: spec/plan/tasks/src 등의 디렉토리 상태를 확인
  • 빌드/테스트 점검: npm run build, npm run test 등 핵심 루프 점검
  • Use Case: 상태가 불안정한 프로젝트를 조기에 발견하고 조치를 추천한다

Quick Start

프로젝트 루트에서 점검 명령을 실행합니다. 예: "npm run build"와 "npm run test"를 순차 실행

Frequently Asked Questions about project-health

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

FAQPage Schema
How do I diagnose build and test failures in my npm project?

Project health checks run your npm build and test scripts sequentially to surface failures fast. The Skill executes npm run build and npm run test, reporting errors and anomalies to prevent issues from reaching production.

Can I automate checking for lint errors and TypeScript issues?

Yes. Automated health checks scan for TypeScript errors and execute lint validation as part of the diagnostic cycle. Results are reported alongside build and test status to catch code quality problems early.

What directory structure does my project need for health checks to work?

Projects must follow a spec-plan-tasks-src layout. Health checks validate that these mandatory directories exist and are properly organized, ensuring your repository structure aligns with the expected SDD (Specification-Driven Development) pattern.

How do I check dependency security and version mismatches?

Health diagnostics perform dependency audits and version synchronization checks. The Skill reports security vulnerabilities and version inconsistencies across your project, helping you maintain consistent and secure dependencies.

What happens if my project fails health checks?

The Skill reports specific status and anomalies when validation fails—missing directories, build errors, test failures, or lint violations. Recommendations guide you toward corrective actions to restore project health.