Skill Dependencies

# Skill Dependencies

Manage dependencies between OpenClaw skills — like npm for skills.

Version Constraints

Supports semver-style version constraints:

```yaml depends: - weather@>=1.0.0 # Version 1.0.0 or higher - calendar@^2.0.0 # Compatible with 2.x.x - browser@~1.2.0 # Approximately 1.2.x - coding-agent@* # Any version - [email protected] # Exact version ```

Conflict Detection

Declare skills that cannot coexist:

```yaml conflicts: - old-weather # Cannot use with old-weather - legacy-calendar ```

Concepts

Declaring Dependencies

In a skill's `SKILL.md` frontmatter: ```yaml --- name: my-skill description: Does something cool depends: - weather # Requires weather skill - coding-agent # Requires coding-agent skill optional: - github # Enhanced if github skill present --- ```

Dependency Types

• depends — Required skills (fail if missing)
• optional — Enhanced functionality if present
• conflicts — Cannot be used with these skills

Commands

Scan Skills ```bash # Scan all installed skills for dependencies ./scripts/scan-skills.sh

# Scan specific skill ./scripts/scan-skills.sh weather ```

Dependency Tree ```bash # Show full dependency tree ./scripts/skill-tree.sh my-skill

# Output: # my-skill # ├── weather (required) # │ └── (no dependencies) # └── coding-agent (required) # └── github (optional) ```

Check Missing ```bash # Find skills with unmet dependencies ./scripts/check-deps.sh ```

Registry Format

Skills can declare their metadata in `skill.json`: ```json { "name": "my-skill", "version": "1.0.0", "depends": { "weather": ">=1.0.0", "coding-agent": "*" }, "optional": { "github": ">=2.0.0" } } ```

Skill Locations

1. Scans these directories:
2. `/usr/lib/node_modules/openclaw/skills/` — Built-in skills
3. `~/.openclaw/workspace/skills/` — User skills
4. `./skills/` — Project-local skills

ClawHub Registry Integration

Install skills from clawhub.com:

```bash # Install a skill (auto-resolves dependencies) ./scripts/skill-install.sh weather

# Install with specific version ./scripts/skill-install.sh [email protected]

# Search for skills ./scripts/skill-search.sh "calendar"

# List installed vs available ./scripts/skill-list.sh --outdated ```

Auto-Resolution

When installing a skill with dependencies: ``` $ ./scripts/skill-install.sh travel-planner

📦 Resolving dependencies for [email protected]... ├── weather@>=1.0.0 → [email protected] ✅ ├── calendar@^2.0 → [email protected] ✅ └── browser (optional) → [email protected] ✅

🔍 Checking conflicts... └── No conflicts found ✅

📥 Installing 4 skills... ✅ [email protected] ✅ [email protected] ✅ [email protected] ✅ [email protected]

Done! Installed 4 skills. ```

Commands Summary

| Command | Description | |---------|-------------| | `scan-skills.sh` | List all skills with their deps | | `skill-tree.sh <name>` | Show dependency tree | | `check-deps.sh` | Find missing dependencies | | `skill-install.sh <name>` | Install from ClawHub | | `skill-search.sh <query>` | Search registry | | `check-conflicts.sh` | Detect conflicts |