The skills command manages agent skills - modular capabilities that extend what the agent can do.
Usage weaver skills < subcomman d > [options]
Subcommands list Display all installed skills from workspace, global, and builtin directories.
Output:
Installed Skills: ------------------ ✓ weather (workspace) Get current weather and forecasts ✓ calculator (builtin) Perform mathematical calculations ✓ news (global) Fetch latest news articles
install Install a skill from GitHub repository.
weaver skills install < rep o >
GitHub repository in format owner/repo or domain/owner/repo Examples:
operator.onl/weaver-skills/weatherusername/skill-name Installs to: ~/.weaver/workspace/skills/<skill-name>/
remove Uninstall a skill from workspace.
weaver skills remove < skill-nam e >
Alias: uninstallName of the skill to remove (directory name)
show Display detailed information about a skill.
weaver skills show < skill-nam e >
Name of the skill to display
Output:
📦 Skill: weather ---------------------- Provides current weather conditions and forecasts. Usage: "What's the weather in Tokyo?" "Will it rain tomorrow?" Requirements: - OpenWeather API key in config
search Search available skills from online registry.
Output:
Searching for available skills... Available Skills (12): -------------------- 📦 weather Get weather forecasts and conditions Repo: operator.onl/weaver-skills/weather Author: Weaver Team Tags: [weather, api, forecast] 📦 stock Stock market data and quotes Repo: operator.onl/weaver-skills/stock Author: Weaver Team Tags: [finance, stocks, market]
install-builtin Copy all builtin skills to workspace for customization.
weaver skills install-builtin
Copies from builtin directory to ~/.weaver/workspace/skills/
Builtin skills:
weather - Weather forecastsnews - News articlesstock - Stock quotescalculator - Math calculations
list-builtin Show available builtin skills.
weaver skills list-builtin
Output:
Available Builtin Skills: ----------------------- ✓ weather Weather forecasts and conditions ✓ calculator Mathematical calculations
Skill Structure A skill is a directory containing:
skill-name/ ├── SKILL.md # Skill definition and instructions (required) ├── README.md # Documentation (optional) ├── config.json # Configuration schema (optional) └── resources/ # Additional files (optional)
SKILL.md format: --- name : weather description : Get current weather and forecasts author : Weaver Team tags : [ weather , api ] --- This skill provides weather information using OpenWeather API. Usage instructions for the agent...
Skill Loading Skills are loaded from three locations in order:
Workspace: ~/.weaver/workspace/skills/ (highest priority)Global: ~/.weaver/skills/Builtin: ~/.weaver/weaver/skills/ (embedded with binary)
If a skill exists in multiple locations, workspace version takes precedence.
Examples Install from GitHub
List installed
Show skill details
Remove skill
Install builtin
Search online
No skills
$ weaver skills install operator.onl/weaver-skills/weather Installing skill from operator.onl/weaver-skills/weather... ✓ Skill 'weather' installed successfully!
Exit Codes Code Reason 0 Success 1 Installation failed 1 Skill not found 1 Network error (install/search)
Error Handling Installation Errors ✗ Failed to install skill: repository not found
Verify repository path and access.
✗ Failed to install skill: no SKILL.md found
Repository must contain a valid SKILL.md file.
Removal Errors ✗ Failed to remove skill: skill not found in workspace
Cannot remove builtin or global skills, only workspace.
Search Errors ✗ Failed to fetch skills list: network timeout
Check internet connection.
Skill Development To create a custom skill:
Create directory
mkdir -p ~/.weaver/workspace/skills/my-skill cd ~/.weaver/workspace/skills/my-skill
Create SKILL.md
--- name : my-skill description : Does something useful --- This skill helps the agent with X, Y, and Z. When the user asks about [ topic ], use this approach: 1. First, do A 2. Then, do B 3. Finally, respond with C
Test with agent
weaver agent -m "Use my-skill to do X"
Optional: Add resources
mkdir resources # Add templates, scripts, etc.
Skill Availability Skills may be unavailable if:
Missing required API keys in config
Syntax errors in SKILL.md
Missing dependencies
Check availability:
$ weaver gateway 📦 Agent Status: • Skills: 4/6 available
Unavailable skills are loaded but marked inactive.