System Diagnostician

Diagnose project health and generate a prioritized capability-action plan.

34|7|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daffy0208/ai-dev-standards --skill system-diagnostician
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: System Diagnostician
Source: https://github.com/daffy0208/ai-dev-standards/tree/main/SKILLS/system-diagnostician
Command: npx skills add https://github.com/daffy0208/ai-dev-standards --skill system-diagnostician

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires codex, jq, python3, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the guesswork in project assessment by automatically identifying health issues, capability gaps, and providing prioritized improvement plans.

Core Features & Use Cases

  • Comprehensive Health Analysis: Assesses testing, security, performance, documentation, and architecture across your codebase.
  • Capability Gap Detection: Identifies missing or incomplete capabilities using AI-powered analysis.
  • Use Case: Imagine you've just inherited a legacy codebase. Use this Skill to quickly identify critical security vulnerabilities, missing test coverage, and recommend specific capabilities to address them.

Quick Start

Use the System Diagnostician to analyze the current project directory and identify the top 5 capability gaps that need immediate attention.

Frequently Asked Questions about System Diagnostician

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

FAQPage Schema
How do I diagnose project health and identify capability gaps?

Project health diagnosis analyzes testing, security, performance, documentation, and architecture to surface capability gaps. This Skill applies AI-powered analysis to detect missing or incomplete capabilities and generate a prioritized improvement plan based on codebase structure and anti-pattern detection.

Can I use code analysis to assess a legacy codebase for security vulnerabilities and test coverage?

Yes. Automated code analysis identifies security vulnerabilities, missing test coverage, and performance issues across inherited codebases. This Skill performs comprehensive health assessment and dependency review to surface critical gaps and recommend specific capabilities to address them.

What does a capability-action plan from codebase analysis include?

A capability-action plan prioritizes identified improvement areas by severity and impact. It includes health scores across testing, security, performance, and documentation domains, ranked recommendations for missing capabilities, and specific enhancements tied to dependency analysis and anti-pattern detection results.

How do I get started analyzing a project's health and improvement needs?

Run the System Diagnostician on your current project directory. It automatically scans your codebase structure, dependencies, and code patterns to identify the top capability gaps requiring immediate attention and produces a ranked improvement plan.

What dependencies and tools does project health analysis require?

Project health diagnosis requires codex for AI-powered analysis, jq for structured data processing, and python3 for scripting. These enable codebase scanning, anti-pattern detection, dependency review, and health-scoring calculations.

When should I run a project health assessment versus a targeted security or performance audit?

Run comprehensive health assessment during onboarding or periodic reviews to establish baseline capability coverage across all domains. Use targeted analysis when addressing specific concerns like security vulnerabilities or performance bottlenecks identified in the broader health report.