How do I install the Skill Deps Doctor skill?

Run npx skillmds@latest add knownasnaffy/skill-deps-doctor-3 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.

Is Skill Deps Doctor safe to use?

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

Which AI agents work with Skill Deps Doctor?

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 Skill Deps Doctor free to use?

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

Who published Skill Deps Doctor?

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

Skill Deps Doctor by knownasnaffy — Agent Skill

Name: Skill Deps Doctor
Rating: 4.5 (4 reviews)
Author: knownasnaffy

Skill Deps Doctor

Cross-platform skill dependency doctor — preflight check for missing binaries, version mismatches, system libraries, CJK fonts, Playwright/Chromium runtime, and project-level deps. Use before running skills to prevent late runtime dependency failures.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

🧰 Skill Deps Doctor

Complementary to openclaw doctor — doctor checks gateway/config/services; this skill checks skill runtime dependencies (bins, versions, libs, fonts).

Use this skill to detect missing or broken dependencies before a skill fails at runtime.

What it checks

🔎 Binary presence — scans skills/*/SKILL.md declared requires.bins against $PATH
📌 Version constraints — node>=18, python3>=3.10 syntax with actual version probing
🧩 Shared libraries — Playwright/Chromium native deps via ldconfig (Linux)
🔤 CJK fonts — prevents PDF tofu (□) via fc-list
🔗 Transitive native deps — e.g. playwright → 13 .so libraries
📦 Project presets via --check-dir:
- Node (package.json), Python (pyproject.toml / requirements.txt), Docker (Dockerfile)
- Cross-references npm/pip packages against system-dep hints
🎚️ Playwright probes — Node + Python detection + Chromium headless launch smoke test
📦 Dependency profiles — --profile slidev, --profile whisper, --profile pdf-export
🔌 Plugin system — third-party checkers via Python entry points

Install

pip install skill-deps-doctor

Legacy command skill-deps-doctor remains supported for compatibility.

Usage

Basic check

skill-deps-doctor --skills-dir /path/to/workspace/skills

Scan a project directory (with probes)

skill-deps-doctor --skills-dir ./skills --check-dir ./project --probe

Monorepo recursive scan

skill-deps-doctor --skills-dir ./skills --check-dir ./monorepo --recursive

Dependency profiles

skill-deps-doctor --skills-dir ./skills --profile slidev --profile pdf-export
skill-deps-doctor --skills-dir ./skills --list-profiles

Generate fix script

skill-deps-doctor --skills-dir ./skills --fix > fix.sh

Dependency graph

skill-deps-doctor --skills-dir ./skills --graph tree
skill-deps-doctor --skills-dir ./skills --graph dot | dot -Tsvg -o deps.svg

Cross-platform fix matrix

skill-deps-doctor --skills-dir ./skills --platform-matrix

JSON output (CI)

skill-deps-doctor --skills-dir ./skills --json

Environment snapshot + baseline regression gating

# Save baseline
skill-deps-doctor --skills-dir ./skills --snapshot baseline.json

# Gate on new issues
skill-deps-doctor --skills-dir ./skills --baseline baseline.json --fail-on-new
# Exit: 0 = pass, 2 = errors, 3 = new findings vs baseline

Validate hints schema & plugin contracts

skill-deps-doctor --skills-dir ./skills --validate-hints
skill-deps-doctor --skills-dir ./skills --validate-plugins

Custom hints override

skill-deps-doctor --skills-dir ./skills --hints-file my-hints.yaml

Verbosity

skill-deps-doctor --skills-dir ./skills -v        # Show all (including info)
skill-deps-doctor --skills-dir ./skills -q        # Errors only
skill-deps-doctor --skills-dir ./skills --no-plugins  # Skip third-party plugins

Fallback wrapper (repo/dev layout)

python {baseDir}/scripts/skill-deps-doctor.py --skills-dir ./skills

Notes

Linux: shared-lib checks via ldconfig; font checks via fc-list; auto-adapts apt hints to host package manager (dnf / yum / apk / pacman).
macOS / Windows: binary + version + font checks work; Playwright checks rely on probes (--probe).
CI integration: use --json for machine-readable output, --snapshot + --baseline --fail-on-new for regression gating.

---name: skill-deps-doctor-3description: Cross-platform skill dependency doctor — preflight check for missing binaries, version mismatches, system libraries, CJK fonts, Playwright/Chromium runtime, and project-level deps. Use before running skills to prevent late runtime dependency failures.---# 🧰 Skill Deps Doctor> **Complementary to `openclaw doctor`** — `doctor` checks gateway/config/services;> this skill checks **skill runtime dependencies** (bins, versions, libs, fonts).Use this skill to **detect missing or broken dependencies before a skill fails at runtime**.## What it checks- 🔎 **Binary presence** — scans `skills/*/SKILL.md` declared `requires.bins` against `$PATH`- 📌 **Version constraints** — `node>=18`, `python3>=3.10` syntax with actual version probing- 🧩 **Shared libraries** — Playwright/Chromium native deps via `ldconfig` (Linux)- 🔤 **CJK fonts** — prevents PDF tofu (□) via `fc-list`- 🔗 **Transitive native deps** — e.g. `playwright` → 13 `.so` libraries- 📦 **Project presets** via `--check-dir`: - Node (`package.json`), Python (`pyproject.toml` / `requirements.txt`), Docker (`Dockerfile`) - Cross-references npm/pip packages against system-dep hints- 🎚️ **Playwright probes** — Node + Python detection + Chromium headless launch smoke test- 📦 **Dependency profiles** — `--profile slidev`, `--profile whisper`, `--profile pdf-export`- 🔌 **Plugin system** — third-party checkers via Python entry points## Install```bashpip install skill-deps-doctor```Legacy command `skill-deps-doctor` remains supported for compatibility.## Usage### Basic check```bashskill-deps-doctor --skills-dir /path/to/workspace/skills```### Scan a project directory (with probes)```bashskill-deps-doctor --skills-dir ./skills --check-dir ./project --probe```### Monorepo recursive scan```bashskill-deps-doctor --skills-dir ./skills --check-dir ./monorepo --recursive```### Dependency profiles```bashskill-deps-doctor --skills-dir ./skills --profile slidev --profile pdf-exportskill-deps-doctor --skills-dir ./skills --list-profiles```### Generate fix script```bashskill-deps-doctor --skills-dir ./skills --fix > fix.sh```### Dependency graph```bashskill-deps-doctor --skills-dir ./skills --graph treeskill-deps-doctor --skills-dir ./skills --graph dot | dot -Tsvg -o deps.svg```### Cross-platform fix matrix```bashskill-deps-doctor --skills-dir ./skills --platform-matrix```### JSON output (CI)```bashskill-deps-doctor --skills-dir ./skills --json```### Environment snapshot + baseline regression gating```bash# Save baselineskill-deps-doctor --skills-dir ./skills --snapshot baseline.json# Gate on new issuesskill-deps-doctor --skills-dir ./skills --baseline baseline.json --fail-on-new# Exit: 0 = pass, 2 = errors, 3 = new findings vs baseline```### Validate hints schema & plugin contracts```bashskill-deps-doctor --skills-dir ./skills --validate-hintsskill-deps-doctor --skills-dir ./skills --validate-plugins```### Custom hints override```bashskill-deps-doctor --skills-dir ./skills --hints-file my-hints.yaml```### Verbosity```bashskill-deps-doctor --skills-dir ./skills -v # Show all (including info)skill-deps-doctor --skills-dir ./skills -q # Errors onlyskill-deps-doctor --skills-dir ./skills --no-plugins # Skip third-party plugins```### Fallback wrapper (repo/dev layout)```bashpython {baseDir}/scripts/skill-deps-doctor.py --skills-dir ./skills```## Notes- **Linux**: shared-lib checks via `ldconfig`; font checks via `fc-list`; auto-adapts `apt` hints to host package manager (dnf / yum / apk / pacman).- **macOS / Windows**: binary + version + font checks work; Playwright checks rely on probes (`--probe`).- **CI integration**: use `--json` for machine-readable output, `--snapshot` + `--baseline --fail-on-new` for regression gating.

Frequently asked questions