Diagnostic Runner Skill

Run comprehensive system diagnostics to identify issues, verify configurations, and report system health.

When to Use

✅ USE this skill when:

• "Run diagnostics on the system"
• "Check if everything is configured correctly"
• "Verify dependencies are installed"
• "Troubleshoot system issues"
• "Generate a health report"
• "Check environment status"

When NOT to Use

❌ DON'T use this skill when:

• Simple file operations ΓåÆ use bash directly
• Installing packages ΓåÆ use package manager
• Network requests ΓåÆ use http-request

Commands

Full Diagnostic

{baseDir}/diagnose.sh

Runs all diagnostic checks and outputs a comprehensive report.

Quick Health Check

{baseDir}/diagnose.sh --quick

Runs essential checks only (faster).

Specific Check Categories

{baseDir}/diagnose.sh --category environment
{baseDir}/diagnose.sh --category dependencies
{baseDir}/diagnose.sh --category permissions
{baseDir}/diagnose.sh --category network
{baseDir}/diagnose.sh --category config
{baseDir}/diagnose.sh --category storage

Output Formats

{baseDir}/diagnose.sh --format json
{baseDir}/diagnose.sh --format markdown
{baseDir}/diagnose.sh --format text

Diagnostic Categories

Category	Checks
environment	Node.js version, Python version, PATH, env vars, shell config
dependencies	Installed tools, package managers, runtime versions
permissions	File read/write access, directory permissions, sudo status
network	DNS resolution, outbound connectivity, port availability
config	Config file validity, required fields, deprecated settings
storage	Disk space, inode usage, temp directory access, file handles

Output Format (JSON)

{
  "timestamp": "2026-02-25T20:41:00Z",
  "status": "pass|warn|fail",
  "summary": {
    "passed": 12,
    "warnings": 3,
    "failed": 0
  },
  "checks": [
    {
      "category": "environment",
      "name": "Node.js Version",
      "status": "pass",
      "message": "v22.0.0 (required: >=18)",
      "details": {...}
    }
  ]
}

Examples

Full diagnostic:

{baseDir}/diagnose.sh

Quick check with JSON output:

{baseDir}/diagnose.sh --quick --format json

Check only environment and dependencies:

{baseDir}/diagnose.sh --category environment --category dependencies

Notes

• Non-destructive: only reads and verifies, never modifies
• Safe to run at any time
• Can be automated for scheduled health monitoring
• Exit code 0 = all passed, 1 = warnings, 2 = failures