How do I install the Diagnostic Runner skill?

Run npx skillmds@latest add winsorllc/diagnostic-runner in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Diagnostic Runner skill do?

--- It is listed under Coding & Dev Tools on SkillMD.

Is Diagnostic Runner safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Diagnostic Runner?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Diagnostic Runner free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Diagnostic Runner?

winsorllc (@winsorllc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Diagnostic Runner by winsorllc — Agent Skill

Name: Diagnostic Runner
Author: winsorllc

File contents

--- name: diagnostic-runner description: "Run system diagnostics and health checks. Inspect environment, dependencies, permissions, and configuration. Inspired by ZeroClaw/OpenClaw 'doctor' command."

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

---name: diagnostic-runnerdescription: ---------name: diagnostic-runnerdescription: "Run system diagnostics and health checks. Inspect environment, dependencies, permissions, and configuration. Inspired by ZeroClaw/OpenClaw 'doctor' command."---# Diagnostic Runner SkillRun 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```bash{baseDir}/diagnose.sh```Runs all diagnostic checks and outputs a comprehensive report.### Quick Health Check```bash{baseDir}/diagnose.sh --quick```Runs essential checks only (faster).### Specific Check Categories```bash{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```bash{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)```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:**```bash{baseDir}/diagnose.sh```**Quick check with JSON output:**```bash{baseDir}/diagnose.sh --quick --format json```**Check only environment and dependencies:**```bash{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

Frequently asked questions

Diagnostic Runner