ClawdBotAI

Overview

Clawdbot uses AgentSkills-compatible skill folders to teach the agent how to use tools. Each skill is a directory containing a SKILL.md with YAML frontmatter and instructions.

Clawdbot loads bundled skills plus optional local overrides, and filters them at load time based on environment, config, and binary presence.

Locations and precedence

Skills are loaded from three places:

Bundled skills: shipped with the install (npm package or Clawdbot.app)
Managed/local skills: ~/.clawdbot/skills
Workspace skills: <workspace>/skills

If a skill name conflicts, precedence is:

<workspace>/skills (highest)
~/.clawdbot/skills
bundled skills (lowest)

Additionally, you can configure extra skill folders (lowest precedence) via skills.load.extraDirs in ~/.clawdbot/clawdbot.json.

Per-agent vs shared skills

In multi-agent setups, each agent has its own workspace. That means:

Per-agent skills live in <workspace>/skills for that agent only.
Shared skills live in ~/.clawdbot/skills (managed/local) and are visible to all agents on the same machine.

Shared folders can also be added via skills.load.extraDirs (lowest precedence) if you want a common skills pack used by multiple agents.

ClawdHub (install + sync)

ClawdHub is the public skills registry for Clawdbot. Browse at https://clawdhub.com.

Use it to discover, install, update, and back up skills.

Common flows

# Install a skill into your workspace
clawdhub install <skill-slug>

# Update all installed skills
clawdhub update --all

# Sync (scan + publish updates)
clawdhub sync --all

By default, clawdhub installs into ./skills under your current working directory (or falls back to the configured Clawdbot workspace). Clawdbot picks that up as <workspace>/skills on the next session.

Format (AgentSkills + Pi-compatible)

SKILL.md must include at least:

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

Notes:

We follow the AgentSkills spec for layout/intent.
The parser used by the embedded agent supports single-line frontmatter keys only.
metadata should be a single-line JSON object.
Use {baseDir} in instructions to reference the skill folder path.

Optional frontmatter keys

Key	Description
`homepage`	URL surfaced as "Website" in the macOS Skills UI
`user-invocable`	true\|false (default: true). When true, exposed as a user slash command
`disable-model-invocation`	true\|false (default: false). When true, excluded from model prompt
`command-dispatch`	tool (optional). When set, slash command bypasses the model
`command-tool`	Tool name to invoke when command-dispatch: tool is set

Gating (load-time filters)

Skills can be filtered at load time based on:

Environment variables
Config settings
Binary presence (e.g., require a specific CLI tool)

Config reference

{
  "skills": {
    "load": {
      "extraDirs": ["/path/to/shared/skills"]
    }
  }
}

Plugins + skills

Plugins can ship their own skills by listing skills directories in clawdbot.plugin.json (paths relative to the plugin root).

Plugin skills load when the plugin is enabled and participate in the normal skill precedence rules.

Skills