Skills, Vercel Skills, and SOUL.md

Use local Markdown skills, optional Vercel Skills discovery, and SOUL.md persona files to make Libre Claw reuse project workflows safely.

Skill locations

Skills are Markdown playbooks loaded from bundled, external, global, and project-local directories.

Skill paths
~/.libre-claw/skills/
<project>/.libre-claw/skills/
~/.libre-claw/skills/catalogs/
src/libre_claw/skills/

Project skills override global, external, and bundled skills. External catalogues stay read-only until copied locally.

AgentSkills format

Libre Claw supports AgentSkills-style packages with a SKILL.md file.

SKILL.md
---
name: hacker-news-brief
description: Use for HN, startup, coding, AI, infra, security, and open-source brief requests.
---

# Hacker News Brief

When the user asks for Hacker News, fetch IDs, fetch item details, compare memory, and return only a final concise brief.

Vercel Skills discovery

Enable the open skills ecosystem when you want Libre Claw to look for specialized playbooks during a task.

~/.libre-claw/config.toml
[skills]
external_discovery_enabled = true
external_auto_refresh = true
vercel_source_enabled = true
vercel_repo_url = "https://github.com/vercel-labs/skills.git"
cli_command = "npx -y skills@latest"

The agent gets a read-only skills_search tool. Installing or editing a skill remains explicit.

SOUL.md

A SOUL.md file customizes persona and collaboration style without changing source code.

Persona paths
~/.libre-claw/SOUL.md
<project>/.libre-claw/SOUL.md
<project>/SOUL.md

Commands

Skill commands
/skills list
/skills sync
/skills show hacker-news-brief
/skills show --external find-skills
/skills add --project server-monitor
/soul status
/soul init --project