city skill

Manage skill discovery, installation, and lookup.

Hierarchy note: city skill is a service action command, not a top-level command. Top-level entry is city service.

Usage

city skill <subcommand> [options]

Subcommands

• find <query>
• install <spec>
• list
• lookup <name>

install key options

• -g, --global: global install (default true)
• -y, --yes: skip confirmation (default true)
• --agent <agent>: default claude-code

Examples

city skill list
city skill lookup playwright

# install only when missing from `list`
city skill find playwright
city skill install owner/repo@playwright
city skill lookup playwright

Recommended flow

list -> lookup (if missing, then find -> install -> lookup)

Runtime behavior

• In Agent runtime, lookup tool output returns status only.
• Skill content is injected through the next user message wrapped in <skill>...</skill>.

Example Output (Based on Current Implementation)

The examples below are aligned with current command implementations in package/src (including default output mode and field structure). Placeholder values are used for environment-specific fields.

$ city skill list
{
  "success": true,
  "data": {
    "success": true,
    "skills": []
  }
}

$ city skill lookup playwright
{
  "success": true,
  "data": {
    "success": true,
    "name": "playwright"
  }
}