🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Skill Deps Doctor

by @rangeking

Cross-platform skill dependency doctor — preflight check for missing binaries, version mismatches, system libraries, CJK fonts, Playwright/Chromium runtime,...

Versionv0.1.0
💡 Examples

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

📋 Tips & Best Practices

  • 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.
  • View on ClawHub
    TERMINAL
    clawhub install skill-deps-doctor

    🧪 Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    🔍 Can't find the right skill?

    Search 60,000+ AI agent skills — free, no login needed.

    Search Skills →