Skills System

What are Skills

Skills are Markdown instruction files that extend the AI’s capabilities. You can define specific workflows, domain knowledge, or behavioral rules for the AI.

Built-in Skills

SoAgents automatically installs these skills on first launch:

  • PDF — Read and process PDF files
  • XLSX — Work with Excel spreadsheets
  • DOCX — Handle Word documents
  • PPTX — Create presentations
  • Skill Creator — A meta-skill that helps you create new skills
  • Summarization — Content summarization

Skill Storage

  • Global Skills — ~/.soagents/skills/, available to all workspaces
  • Project Skills — {workspace}/.claude/skills/, workspace-specific
  • Project skills override global skills when names conflict

Creating Custom Skills

Create a folder and SKILL.md under ~/.soagents/skills/:

~/.soagents/skills/my-skill/
└── SKILL.md

Skill file format:

---
name: my-skill
description: What this skill does
author: Your name
user-invocable: true
---

# Skill Instructions

Write detailed instructions for the AI here...

Common Fields

FieldDescription
nameSkill name
descriptionDescription — AI uses this to decide when to apply the skill
user-invocableWhether users can trigger it via /skill-name
allowed-toolsRestrict which tools the skill can use

Managing Skills

In Settings → Skills you can:

  • View all installed skills
  • Enable/disable skills
  • View skill details and content
  • Built-in skills can’t be deleted, but can be disabled

Using Skills

In conversation, the AI automatically matches relevant skills to your request. You can also explicitly say “use xxx skill” to specify one.

If a skill has user-invocable: true, you can invoke it directly with /skill-name.