Skip to main content

​
Overview

Skills extend agent capabilities with specialized instructions, workflows, and bundled resources. The spacebot skill command manages installation, listing, and removal of skills.

​
Subcommands

  • add - Install a skill from GitHub or skills.sh registry
  • install - Install a skill from a .skill file
  • list - List installed skills
  • remove - Remove an installed skill
  • info - Show skill details

​
add

Install a skill from GitHub or the skills.sh registry.

​
Usage

spacebot skill add <SPEC> [OPTIONS]

​
Arguments

​
SPEC
string
required
Skill specification. Formats:
  • owner/repo - Install all skills from the repository
  • owner/repo/skill-name - Install a specific skill from the repository

​
Options

​
--agent
string
Agent ID to install the skill for. Defaults to the first agent in your configuration.
​
--instance
boolean
default:"false"
Install to the instance-level skills directory, making it available to all agents.

​
Examples

​
Install from GitHub

spacebot skill add opencode/skills
Output: 
Installing skill from: opencode/skills
Target directory: /home/user/.spacebot/agents/default/skills

Successfully installed 3 skill(s):
  - doc-reader
  - doc-author
  - update-nav

​
Install specific skill

spacebot skill add opencode/skills/doc-reader
Output: 
Installing skill from: opencode/skills/doc-reader
Target directory: /home/user/.spacebot/agents/default/skills

Successfully installed 1 skill(s):
  - doc-reader

​
Install for specific agent

spacebot skill add opencode/skills --agent coding-assistant

​
Install instance-wide

spacebot skill add opencode/skills --instance
Output: 
Installing skill from: opencode/skills
Target directory: /home/user/.spacebot/skills

Successfully installed 3 skill(s):
  - doc-reader
  - doc-author
  - update-nav

​
Skill Sources

  • GitHub: Fetches from https://github.com/owner/repo
  • Registry: Resolves short names via skills.sh registry (future feature)

​
install

Install a skill from a local .skill file.

​
Usage

spacebot skill install <PATH> [OPTIONS]

​
Arguments

​
PATH
path
required
Path to the .skill file to install.

​
Options

​
--agent
string
Agent ID to install the skill for. Defaults to the first agent in your configuration.
​
--instance
boolean
default:"false"
Install to the instance-level skills directory, making it available to all agents.

​
Examples

​
Install from local file

spacebot skill install ./custom-skill/SKILL.md
Output: 
Installing skill from: ./custom-skill/SKILL.md
Target directory: /home/user/.spacebot/agents/default/skills

Successfully installed 1 skill(s):
  - custom-skill

​
Install with absolute path

spacebot skill install /etc/spacebot/skills/enterprise.skill

​
list

List all installed skills for an agent.

​
Usage

spacebot skill list [OPTIONS]

​
Options

​
--agent
string
Agent ID to list skills for. Defaults to the first agent in your configuration.

​
Examples

​
List skills

spacebot skill list
Output: 
Installed skills (5):

  doc-reader (instance)
    Read and navigate external documentation efficiently.

  doc-author (instance)
    Write, edit, and maintain documentation.

  mintlify (workspace)
    Comprehensive reference for building Mintlify documentation sites.

  update-nav (workspace)
    Add new pages to docs.json navigation structure.

  custom-analysis (workspace)
    Analyze code complexity and suggest refactorings.

​
List for specific agent

spacebot skill list --agent coding-assistant

​
Output Format

Each skill shows:
  • Name: The skill identifier
  • Source: instance (shared across agents) or workspace (agent-specific)
  • Description: One-line summary from the skill file

​
remove

Remove an installed skill.

​
Usage

spacebot skill remove <NAME> [OPTIONS]

​
Arguments

​
NAME
string
required
The name of the skill to remove.

​
Options

​
--agent
string
Agent ID the skill is installed for. Defaults to the first agent in your configuration.

​
Examples

​
Remove skill

spacebot skill remove doc-reader
Output: 
Removed skill: doc-reader
Path: /home/user/.spacebot/agents/default/skills/doc-reader

​
Skill not found

$ spacebot skill remove nonexistent
Skill not found: nonexistent
Exit code: 1

​
info

Show detailed information about an installed skill.

​
Usage

spacebot skill info <NAME> [OPTIONS]

​
Arguments

​
NAME
string
required
The name of the skill to inspect.

​
Options

​
--agent
string
Agent ID the skill is installed for. Defaults to the first agent in your configuration.

​
Examples

​
Show skill info

spacebot skill info doc-reader
Output: 
Skill: doc-reader
Description: Read and navigate external documentation efficiently.
Source: instance
Path: /home/user/.spacebot/skills/doc-reader/SKILL.md
Base directory: /home/user/.spacebot/skills/doc-reader

Content preview (first 500 chars):

# doc-reader skill

Read and navigate external documentation efficiently. Invoke when the task requires checking how a specific function, endpoint, or configuration option works; when the user references an API, SDK, library, or third-party tool by name; when any docs URL or documentation site is mentioned; or when implementing something that depends on an external service or package.

## Usage

1. Identify the documentation URL
2. Fetch the page content
3. Extract relevant sections
4. Summarize for the use...

... (1247 more characters)

​
Skill Resolution

When loading skills for an agent, Spacebot searches two directories:
  1. Instance-level (~/.spacebot/skills/) - Shared across all agents
  2. Workspace-level (~/.spacebot/agents/{agent_id}/skills/) - Agent-specific
Workspace skills override instance skills with the same name.

​
Skill File Format

Skills are markdown files (.md or .skill) with: 
# skill-name

One-line description here.

## Detailed instructions

...
Skills can bundle additional resources (scripts, templates, references) in the same directory.

​
Error Cases

​
No agents configured

$ spacebot skill list
Error: no agents configured
Solution: Configure at least one agent in ~/.spacebot/config.toml.

​
Agent not found

$ spacebot skill list --agent nonexistent
Error: agent not found: nonexistent
Solution: Use --agent with a valid agent ID from your config.

​
GitHub fetch failure

$ spacebot skill add invalid/repo
Error: failed to install skill
Caused by:
    HTTP 404: Repository not found
Solution: Verify the repository exists and is public.

​
Implementation Notes

  • Skills are loaded at agent initialization time
  • Adding/removing skills requires a daemon restart to take effect
  • Skill names must be unique within an agent’s resolution scope
  • The .skill extension is optional (.md files work too)

Build docs developers (and LLMs) love

Get started for freeTalk to us