SkyKoiSKYKOIDocs
Docs/Agent Capabilities/Custom Skills

Custom Skills

Extend agent capabilities with custom skill folders.

Skills are the extensibility layer for SkyKoi agents. Each skill is a directory containing a SKILL.md file with YAML frontmatter and instructions that teach the agent how to use a specific tool or perform a specific task.

Skill Structure

text
skills/
  my-skill/
    SKILL.md          # Required: frontmatter + instructions
    scripts/          # Optional: executable scripts
      run.sh
    data/             # Optional: reference data
      config.json

SKILL.md Format

markdown
---
name: deploy-helper
description: Helps deploy applications to AWS
---

# Deploy Helper

When the user asks to deploy an application, follow these steps:

1. Check the current deployment status
2. Build the application
3. Deploy to the target environment
4. Monitor until stable

Skill Locations

  • •Workspace skills (/home/ubuntu/koi/skills/) — Per-agent, highest priority. Created by the agent itself or placed during provisioning.
  • •Managed skills (Managed skills directory/) — Shared across all agents on the same instance.
  • •Bundled skills — Shipped with the agent runtime (lowest priority).

Name conflicts are resolved by precedence: workspace > managed > bundled.

Skill Gating

Skills can be gated by config, environment, or binary presence via YAML frontmatter. For example, a skill that requires ffmpeg won't load if ffmpeg isn't installed.

💡Your agent can create its own skills! Ask it to write a SKILL.md for a recurring task, and it will be available in future sessions.

NextAPI Overview →