Files
openclaw/docs/cli/skills.md

5.1 KiB
Raw Blame History

summary, read_when, title
summary read_when title
CLI reference for `openclaw skills` (list/info/check) and skill eligibility
You want to see which skills are available and ready to run
You want to debug missing binaries/env/config for skills
skills

openclaw skills

Inspect skills (bundled + workspace + managed overrides) and see whats eligible vs missing requirements.

Related:

Commands

openclaw skills list

List all skills with status, capabilities, and source.

openclaw skills list              # all skills
openclaw skills list --eligible   # only ready-to-use skills
openclaw skills list --json       # JSON output
openclaw skills list -v           # verbose (show missing requirements)

Output columns: Status (+ ready, x missing, x blocked), Skill (name + capability icons), Description, Source.

Capability icons displayed next to skill names:

Icon Capability
>_ shell — run shell commands
📂 filesystem — read/write files
🌐 network — outbound HTTP
🔍 browser — browser automation
sessions — cross-session orchestration
✉️ messaging — send channel messages
scheduling — recurring jobs

Skills blocked by security scanning show x blocked instead of x missing.

Example output:

Skills (10/12 ready)

Status      Skill                          Description                          Source
+ ready     git-autopush >_ 🌐            Automate git workflows               openclaw-managed
+ ready     think                          Extended thinking                    bundled
+ ready     peekaboo 🔍 ⚡                 Browser peek and screenshot          bundled
x missing   summarize >_                   Summarize with CLI tool              bundled
x blocked   evil-injector >_               Totally harmless skill               openclaw-managed
- disabled  old-skill                      Deprecated skill                     workspace

With -v (verbose), two extra columns appear — Scan and Missing:

Status      Skill              Description          Source              Scan        Missing
+ ready     git-autopush >_ 🌐 Automate git wor...  openclaw-managed
x missing   summarize >_       Summarize with...    bundled                         bins: summarize
x blocked   evil-injector >_   Totally harmless...  openclaw-managed    [blocked]
+ ready     sketch-tool 🌐 >_  Generate sketches    openclaw-managed    [warn]

openclaw skills info <name>

Show detailed information about a single skill including security status.

openclaw skills info git-helper
openclaw skills info git-helper --json

Displays: description, source, file path, capabilities (with descriptions), security scan results, requirements (met/unmet), and install options.

Example output:

git-autopush + Ready

  Automate git commit, push, and PR workflows.

  Source        openclaw-managed
  Path          ~/.openclaw/skills/git-autopush/SKILL.md
  Homepage      https://github.com/example/git-autopush
  Primary env   GH_TOKEN

  Capabilities
  >_ shell        Run shell commands
  🌐 network      Make outbound HTTP requests

  Security
  Scan          + clean

  Requirements
  bin           git         + ok
  bin           gh          + ok
  env           GH_TOKEN    + ok

For a skill with missing requirements:

summarize x Missing requirements

  Summarize URLs and files using the summarize CLI.

  Source        bundled
  Path          /opt/openclaw/skills/summarize/SKILL.md

  Capabilities
  >_ shell        Run shell commands

  Security
  Scan          + clean

  Requirements
  bin           summarize   x missing

  Install options
  brew          Install summarize (brew install summarize)

For a skill blocked by scanning:

evil-injector x Blocked (security)

  Totally harmless skill.

  Source        openclaw-managed
  Path          ~/.openclaw/skills/evil-injector/SKILL.md

  Capabilities
  >_ shell        Run shell commands

  Security
  Scan          [blocked] prompt injection detected

openclaw skills check

Security-focused overview of all skills.

openclaw skills check
openclaw skills check --json

Shows: total/eligible/disabled/blocked/missing counts, capabilities requested by community skills, runtime policy restrictions, and scan result summary.

Example output:

Skills Status Check

Status                      Count
Total                       12
Eligible                    10
Disabled                    1
Blocked (allowlist)         0
Missing requirements        1

Community skill capabilities
Icon    Capability    #    Skills
>_      shell         3    git-autopush, deploy-helper, node-runner
📂      filesystem    2    git-autopush, file-editor
🌐      network       2    git-autopush, sketch-tool

Scan results
Result      #
Clean       11
Warning     1
Blocked     0