10x-health-check

Audit an existing project's dependencies, tests, CI/CD, and configuration for agent-readiness.

Updated May 24, 2026
One-click install
npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-health-check-devmachaj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-health-check
Source: https://github.com/DevMachaj/Projekt-certyfikacyjny/tree/main/.claude/skills/10x-health-check
Command: npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-health-check-devmachaj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Before letting an AI agent work on an existing codebase, you need to know whether the project is healthy enough to support agent-assisted development. This Skill audits dependency security, test infrastructure, CI/CD coverage, and configuration completeness, then produces a prioritized report with an agent-readiness verdict. ## Core Features & Use Cases - Dependency and security audit: Detects the language family from project markers (package.json, Cargo.toml, pyproject.toml, go.mod, and more), checks lockfile presence, runs the ecosystem's audit tool (npm audit, pip-audit, cargo audit, govulncheck), and tiers findings by CVSS severity. - Test runner and CI/CD evaluation: Detects test frameworks (Vitest, Jest, pytest, cargo test, RSpec, PHPUnit), attempts a dry run, and scores CI pipeline coverage across lint, test, build, type-check, and security stages. - Structured health report: Writes context/foundation/health-check.md with a healthy / needs-attention / critical-issues verdict, prioritized fixes split into "fix now" vs "covered in upcoming lessons", and cross-references with stack-assessment.md when available. - Use Case: You have a brownfield project and want to start agent-assisted development. Run the health check to discover a missing lockfile, two HIGH npm audit findings, and no test runner, then follow the concrete fix commands before onboarding the agent. ## Quick Start Ask the agent to run a health check on the current project to audit its dependencies, tests, CI, and configuration and write a health report.

Frequently Asked Questions about 10x-health-check

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

FAQPage Schema
How do I check if my existing project is ready for AI agent development?

Run the health check on your project directory. It audits dependency security, verifies a test runner exists and executes, evaluates CI/CD stage coverage, and checks configuration files, then writes a report with an agent-readiness verdict and prioritized fixes.

What does a project health check audit include?

The audit covers lockfile presence, dependency vulnerability scanning with CVSS severity tiering, outdated dependency detection, test runner detection with a dry run, CI/CD stage coverage (lint, test, build, type-check, security), and missing configuration files like .gitignore or strict tsconfig.

Which languages and package managers does the health check support?

It detects JavaScript/TypeScript, Python, Rust, Go, Ruby, PHP, .NET, and Dart projects from their marker files. It dispatches to ecosystem audit tools such as npm audit, pip-audit, cargo audit, govulncheck, bundle audit, and composer audit, skipping gracefully when a tool is unavailable.

Does the health check modify or fix my project automatically?

No. The analysis is strictly read-only. It never runs npm audit fix, upgrades packages, or edits configuration. Every finding includes a concrete fix command in the report, but executing fixes is left to the user.

What happens if my project has no test runner or CI pipeline?

A missing test runner is flagged as a high-priority finding because the agent cannot verify its own changes. Missing CI is treated as an expected gap covered in a later lesson and does not lower the health verdict.

When should I run a health check versus a stack assessment?

Run the stack assessment first to evaluate your technology stack against quality gates, then run the health check to evaluate the project's operational state. When both reports exist, the health check cross-references quality-gate gaps with its operational findings.