Skip to main content
Skills extend Sorat’s capabilities with installable instruction sets. They are Markdown files that get injected into the agent’s system prompt.

​
How skills work

A skill is a directory under ~/.sorat/skills/<name>/ containing a SKILL.md file with YAML frontmatter and instructions: 
---
name: my-skill
description: What this skill does
---

# Instructions

[Instructions, templates, and examples for the agent to follow]
When enabled, the skill’s content is compiled into an XML summary that gets appended to the agent’s system prompt.

​
Installing skills

​
From ClawHub

ClawHub is the default skill registry.
  1. Open the TUI (sorat)
  2. Navigate to Skills > Install Skill
  3. Enter the ClawHub slug (e.g. web-summarizer)

​
From GitHub

Install directly from a GitHub repository: 
curl -X POST http://localhost:8080/api/skills/install \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"source": "github", "repo": "owner/repo"}'
The installer downloads the repository as a ZIP archive and extracts the SKILL.md file.

​
Creating skills

Create a new directory under ~/.sorat/skills/ with a SKILL.md file: 
mkdir -p ~/.sorat/skills/my-skill
my-skill/SKILL.md
---
name: my-skill
description: A custom skill that does something useful
---

# My Skill

When the user asks you to [task], follow these steps:

1. First, [step 1]
2. Then, [step 2]
3. Finally, [step 3]

## Templates

Use this format for output:
...
After creating or modifying a skill, the agent reinitializes automatically when using the API.

​
Managing skills

​
Enable/disable

Skills can be toggled without uninstalling them: 
curl -X PUT http://localhost:8080/api/skills/my-skill \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
Disabled skill names are stored in ~/.sorat/skills/_state.json.

​
Uninstall

curl -X DELETE http://localhost:8080/api/skills/my-skill \
  -H "Authorization: Bearer <token>"
This removes the skill directory entirely and reinitializes the agent.

​
Agent tools for skills

The agent itself can manage skills using built-in tools:
ToolDescription
skill_listList all installed skills
skill_searchSearch skill registries
skill_installInstall a skill from registry or GitHub
This means you can ask the agent to install skills for you in natural language.