Skip to main content

​
Overview

The skills command allows you to manage custom skills that extend your agent’s capabilities. Skills are reusable prompt templates and instructions that can be loaded dynamically. 
picoclaw skills [subcommand]

​
Subcommands

​
list

List all installed skills in your workspace. 
picoclaw skills list
Output: 
Installed skills:
- git-workflow (workspace)
- code-review (workspace)
- mintlify-docs (global)

​
list-builtin

List all built-in skills that come with PicoClaw. 
picoclaw skills list-builtin
Output: 
Builtin skills:
- example-skill
- debug-helper

​
install

Install a skill from a URL or file path. 
picoclaw skills install <url-or-path>
Parameters:
​
url-or-path
string
required
URL to a skill file or local file path
Examples: 
# Install from URL
picoclaw skills install https://example.com/skills/custom-skill.md

# Install from local file
picoclaw skills install /path/to/skill.md

​
install-builtin

Install a built-in skill to your workspace. 
picoclaw skills install-builtin <skill-name>
Parameters:
​
skill-name
string
required
Name of the built-in skill to install
Example: 
picoclaw skills install-builtin example-skill

​
show

Display the content of a skill. 
picoclaw skills show <skill-name>
Parameters:
​
skill-name
string
required
Name of the skill to display
Example: 
picoclaw skills show git-workflow
Search for skills by name or keyword. 
picoclaw skills search <query>
Parameters:
​
query
string
required
Search query (skill name or keyword)
Example: 
picoclaw skills search git

​
remove

Remove an installed skill from your workspace. 
picoclaw skills remove <skill-name>
Parameters:
​
skill-name
string
required
Name of the skill to remove
Example: 
picoclaw skills remove git-workflow

​
Skill Locations

Skills are loaded from three locations in order of priority:
  1. Workspace skills: ~/.picoclaw/workspace/skills/
  2. Global skills: ~/.picoclaw/skills/
  3. Built-in skills: Bundled with PicoClaw installation
Workspace skills override global skills, and global skills override built-in skills with the same name.

​
Creating Custom Skills

Skills are Markdown files with YAML frontmatter. See the Skills feature guide for detailed instructions on creating custom skills. Example skill file: 
---
name: code-review
description: Perform comprehensive code reviews
---

# Code Review Skill

When reviewing code:
1. Check for security vulnerabilities
2. Look for performance issues
3. Verify error handling
4. Check code style and conventions
5. Suggest improvements

​
Use Cases

Project Templates

Install skills for common project setups (Git workflows, CI/CD patterns)

Code Review

Load specialized code review checklists and best practices

Documentation

Install documentation writing guides (Mintlify, OpenAPI, etc.)

Team Standards

Share team-specific coding standards and patterns

​
Next Steps

Skills Feature

Learn about the skills system and how to create custom skills

Agent Configuration

Configure which skills your agent loads

Workspace

Understand workspace structure and file organization

Build docs developers (and LLMs) love

Get started for freeTalk to us