Skip to main content

Skills

Skills are reusable, discoverable capabilities that define what agents can do. They replace the former playbook system with structured YAML-based definitions.

TL;DR: Skills are reusable capabilities that define what agents can do. Each skill has an id, name, description, tags, and examples. Skills are defined in YAML and assigned to agents, providing structured, discoverable functionality.

How Skills Work

Skills are defined as YAML files in services/skills/. Each skill lives in its own subdirectory with a config.yaml file. When an agent is configured, it references skills by id. At runtime, the agent knows what it can do based on its assigned skills.

Managing Skills

# List all skills
systemprompt core skills list

# Show a specific skill
systemprompt core skills show <skill_id>

# Sync skills to database
systemprompt core skills sync --direction to-db -y

Assigning Skills to Agents

Skills are assigned in agent configuration files:

# In services/agents/your-agent.yaml
card:
  skills:
    - id: general_assistance
    - id: content_writing

Learn More

See the Skills Service documentation for the full guide on creating, configuring, and managing skills.