Skip to main content
Skills are reusable instruction documents that give agents specialized knowledge or guidelines. Key properties:
PropertyDescription
namespace / nameUnique identifier
descriptionWhat the skill helps with (shown to the LLM as the tool description)
contentMarkdown instructions
Two modes:
ModeBehaviorBest for
Preloaded (preload: true)Injected into the system promptTone guidelines, safety rules, persona traits
Progressive (preload: false)Exposed as a tool the LLM calls when neededResearch methods, domain expertise, task-specific instructions
Example agent configuration:
enabled_skills:
  - skill: "default/tone_guidelines"
    preload: true       # Always present in system prompt
  - skill: "default/web_research"
    preload: false      # LLM decides when to retrieve it
Endpoints:
POST   /api/v1/skills                       # Create skill
GET    /api/v1/skills                       # List skills
GET    /api/v1/skills/{namespace}/{name}    # Get skill
PUT    /api/v1/skills/{namespace}/{name}    # Update skill
DELETE /api/v1/skills/{namespace}/{name}    # Delete skill