Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Overview

The Crabtalk Hub is a community registry for AI agent resources — MCP servers, skills, agents, and commands. Resources are indexed as TOML manifests in the hub repository and installed via the crabtalk CLI.

Index Layout

Each manifest lives at <scope>/<name>.toml:

microsoft/playwright.toml
notion/notion.toml
crabtalk/search.toml

scope is typically the author, organization, or tool namespace. A single .toml file can declare multiple related resources under the same package.

Installation

crabtalk hub install scope/name

This:

  1. Fetches the manifest from the hub index.
  2. Clones the source repository (if package.repository is set) to ~/.crabtalk/.cache/repos/<slug>/.
  3. Copies the manifest to ~/.crabtalk/packages/<scope>/<name>.toml.
  4. Merges resource definitions (MCP servers, agents, commands) into the user’s crab.toml.
  5. Runs [package.setup] if present.

Directory Conventions

PathPurpose
~/.crabtalk/packages/Installed package manifests
~/.crabtalk/config/Service configuration files (.toml)
~/.crabtalk/.cache/repos/Cached source repository clones
~/.crabtalk/local/agents/Agent prompt files (.md)
~/.crabtalk/local/skills/Installed skill directories (auto-loaded)
~/.crabtalk/config.tomlRuntime configuration (MCP servers, agents, commands)

Skill Discovery

Skills are auto-loaded — no manifest registration required. Crabtalk scans two locations for skill directories:

  1. Local skills — ~/.crabtalk/local/skills/<name>/
  2. Package skills — ~/.crabtalk/.cache/repos/<slug>/skills/<name>/

Any directory containing a SKILL.md file is picked up automatically. Skills follow the agentskills standard and are invoked via /skill-name in the REPL.