skill-dep-fixer for Openclaw

A specialized Node.js CLI tool designed to scan OpenClaw skill files and automatically resolve missing system, npm, pip, and Homebrew dependencies.

christianteohx
v2.0.9
Apr 11, 2026
1
746
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install skill-dep-fixer

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install skill-dep-fixer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is skill-dep-fixer?

skill-dep-fixer is an essential diagnostic and maintenance utility for users of Openclaw Skills. It functions as a system doctor, scanning the SKILL.md files of installed agents to ensure every required binary and package is present. By automating the detection and installation of underlying tools, it eliminates the manual overhead of troubleshooting broken agent workflows.

Built with Node.js, this tool provides a bridge between high-level AI skill definitions and the low-level system requirements they depend on. Whether you are managing a local workspace or a library of installed Openclaw Skills, this fixer ensures your environment remains compatible and fully operational with minimal effort.

skill-dep-fixer Use Cases

  • Troubleshooting broken AI agent workflows when system binaries are missing.
  • Performing a batch health check on all Openclaw Skills after a system migration or OS update.
  • Automating the environment setup for newly cloned or downloaded skills.
  • Generating compact dependency reports for sharing in team communication channels like Discord.

How skill-dep-fixer Works

  1. The user triggers the tool using phrases like openclaw doctor or by running the skill-dep-fixer command directly.
  2. The tool scans the standard Openclaw Skills directories, specifically searching for SKILL.md files in ~/.openclaw/skills/ and workspace subdirectories.
  3. It parses the Markdown frontmatter to extract the metadata.openclaw.install array, identifying required brew, npm, pip, and binary dependencies.
  4. The script executes system checks (e.g., brew list, npm list -g, which) to determine which requirements are unsatisfied.
  5. If the fix flag is provided, the tool automatically executes the necessary installation commands to resolve missing dependencies.
  6. A final report is generated in text, JSON, or Discord-friendly formats, providing a summary of the system's health status.

skill-dep-fixer Setup

Install the tool via Homebrew (recommended for most users):

brew install christianteohx/tap/skill-dep-fixer

Alternatively, install globally via npm:

npm install -g skill-dep-fixer

For a direct binary installation:

curl -fsSL https://github.com/christianteohx/skill-dep-fixer/releases/latest/download/skill-dep-fixer -o ~/bin/skill-dep-fixer
chmod +x ~/bin/skill-dep-fixer

skill-dep-fixer Data Schema & Taxonomy

The skill interacts with the following file structures and metadata within Openclaw Skills:

Data Element Source / Type Description
Skill Frontmatter SKILL.md (YAML) Contains the metadata.openclaw.install definitions.
Dependency IDs metadata.openclaw.install.id Unique identifiers for required packages.
Installation Kind brew, npm, pip, bins The package manager or detection type required.
Formula/Package String The specific name used for installation (e.g., formula name for brew).
Binary Paths bins (Array) List of executable names to verify via the system path.

skill-dep-fixer Advanced Features

  • Dry-run mode using --dry-run to audit missing dependencies without performing any installations.
  • Targeted scanning with the --skill flag to check requirements for a specific tool rather than the entire library.
  • Structured JSON output for integration with other automation scripts or custom dashboards.
  • Compact Discord reporting mode for quick status updates in developer communities.
  • Integrated lifecycle management instructions for keeping both the Openclaw Skills and their underlying packages updated via brew upgrade or npm update.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*