Skills

Downcity supports SKILL.md-based skills.

Default roots

• Project-level: .agents/skills
• User-level: ~/.agents/skills
• Extra roots: downcity.json.plugins.skill.paths

Recommended workflow

1. studio skill list (check already learned/installed local skills first)
2. studio skill lookup <name> (if found, read and execute directly)
3. If missing from list, then run find -> install -> lookup

Example:

studio skill list
studio skill lookup playwright

# only when missing
studio skill find playwright
studio skill install owner/repo@playwright
studio skill lookup playwright

Key rules

• Always lookup before using a skill.
• Skills returned by list are already installed and ready to use.
• Prefer matching learned skills by default when the task fits.
• In the running agent, lookup returns status-only tool output; SKILL.md content is injected as a <skill>...</skill> user message.
• Follow allowed-tools in SKILL.md strictly.
• The agent discovers changed skill files automatically.

Related config

{
  "plugins": {
    "skill": {
      "enabled": true,
      "paths": [".agents/skills"],
      "allowExternalPaths": false
    }
  }
}