Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Capabilities Overview

A capability is a self-contained folder in brain/cerebellum/ that gives Wolffish a new ability. Capabilities are how Wolffish learns to do things — run shell commands, read files, interact with git, search the web, send messages.

​
Two Types of Capabilities

Pure Skills

A SKILL.md file only. The markdown body contains instructions the LLM follows using its existing abilities. No code needed. Example: git/ — the LLM uses shell commands to run git operations based on the SKILL.md instructions.

Plugin Capabilities

A SKILL.md file plus a plugin/ folder with executable code. The plugin exports tools that the LLM can call directly. Example: shell/ — the plugin wraps child_process to provide a shell_exec tool.

​
Capability Folder Structure

brain/cerebellum/my-capability/
├── SKILL.md              # Required: frontmatter + instructions
└── plugin/               # Optional: executable code
    └── index.mjs         # Plugin entry point

​
How Capabilities Are Loaded

On startup, cerebellum.ts scans brain/cerebellum/ and for each folder:
  1. Reads and parses the SKILL.md frontmatter (YAML)
  2. Extracts tool definitions, danger patterns, confirm patterns, and triggers
  3. If a plugin/ folder exists, dynamic-imports plugin/index.mjs
  4. Calls init(context) on the plugin, passing pluginDir and workspaceRoot
  5. Registers all tools with the agent’s tool definitions

​
How Capabilities Are Selected

Not every capability is included in every LLM call. The ras (attention filter) uses the triggers field from SKILL.md frontmatter to score relevance against the user’s message. Only capabilities that pass the relevance threshold are included in the context.

​
Built-In Capabilities

Wolffish ships with these capabilities in the default workspace:
CapabilityTypeDescription
shellPluginExecute shell commands via shell_exec
filesystemPluginRead, write, and patch files
gitPure SkillGit operations via shell commands
introspectPluginSelf-awareness: status, performance, memory tools

Create Your Own

Learn how to build a new capability from scratch.