Synopsis
Description
skill manages profClaw’s skill system. Skills are pre-built, reusable AI agent capabilities defined in SKILL.md files. They extend what agents can do when invoked by name (e.g., commit, review-pr, deploy). Skills can be enabled or disabled at runtime without restarting the server.
Subcommands
| Subcommand | Alias | Description |
|---|---|---|
list | ls | List all skills with enabled status and source |
info <name> | - | Show detailed information for a skill |
enable <name> | - | Enable a disabled skill |
disable <name> | - | Disable an enabled skill |
reload | - | Hot-reload all skills from disk |
skill list
Output as JSON with the full skill list and summary stats.
skill info <name>
Displays name, description, enabled status, source path, eligibility, capabilities, dependencies, and usage statistics (invocation count, average duration, last used).
Output as JSON.
skill enable <name> / skill disable <name>
Toggles a skill on or off. The change takes effect immediately - no server restart needed.
Output result as JSON.
skill reload
Rescans the skills/ directory and reloads all skill definitions from disk. Use this after adding, editing, or removing a SKILL.md file without restarting the server.
Output reload stats (loaded, failed, total) as JSON.
Examples
Skill Sources
| Source | Location | Description |
|---|---|---|
builtin | skills/ in profClaw install | Shipped with profClaw |
local | ~/.profclaw/skills/ | User-defined skills |
plugin | Plugin package | Provided by installed plugins |
Built-in Skills (examples)
| Skill | Description |
|---|---|
commit | Generate and create a git commit with a good message |
review-pr | Code review a GitHub pull request |
deploy | Deploy an application using configured deployment scripts |
analyze-code | Static analysis and suggestions for a codebase |
fix-tests | Diagnose and fix failing tests |
write-docs | Generate documentation for code |
Related
profclaw plugin- Install plugins that provide additional skillsprofclaw tools- Built-in execution tools used by skillsprofclaw chat- Invoke skills in a chat session- Skills Guide - Writing custom skills