Skills

Agent skills for extending CLEO capabilities

Agent Skills

CLEO provides a comprehensive skills system for extending AI agent capabilities through protocol injection.

Architecture (v0.70.0+): CLEO uses a 2-tier universal subagent architecture. All spawns use cleo-subagent with skill-based protocol injection. Skill names like ct-research-agent identify protocols, not separate agent types.

Architecture

Protocol injection, dispatch flow, and 2-tier design

Installation

Install and configure skills

Manifest Schema

Skill registry and dispatch matrix

Marketplace

External skill marketplace (100K+ skills)

Skill Taxonomy

Skills are organized by tier (execution order) and category (functional domain):

Tier 0: Orchestration

Human-in-the-Loop entry points that coordinate workflows.

Skill	Description	Tags
ct-orchestrator	Multi-agent workflow coordination	workflow, multi-agent, coordination

Tier 1: Planning

Decompose complex work into executable units.

Skill	Description	Tags
ct-epic-architect	Epic decomposition and task planning	planning, architecture, task-management

Tier 2: Execution

Perform the actual work.

Skill	Description	Tags
ct-task-executor	General implementation workflows	execution, implementation
ct-research-agent	Information gathering and analysis	research, investigation, discovery
ct-spec-writer	Technical specifications and RFCs	specification, documentation, rfc
ct-test-writer-bats	BATS test creation	testing, bats, integration
ct-library-implementer-bash	Bash library development	implementation, bash, library
ct-validator	Validation and compliance checks	validation, compliance, audit
ct-dev-workflow	Release and deployment workflows	workflow, git, release

Tier 3: Support

Specialized utilities and meta-skills.

Skill	Description	Tags
ct-documentor	Documentation orchestration	documentation, orchestration
ct-docs-lookup	Library documentation via Context7	documentation, libraries
ct-docs-write	Documentation writing (CLEO style)	documentation, writing
ct-docs-review	Documentation review	documentation, review
ct-skill-creator	Skill development guide	skills, creation, meta
ct-skill-lookup	Skill discovery (SkillsMP)	skills, discovery

Dispatch Matrix

Skills are automatically selected based on task context:

By Task Type

{
  "research": "ct-research-agent",
  "planning": "ct-epic-architect",
  "implementation": "ct-task-executor",
  "testing": "ct-test-writer-bats",
  "documentation": "ct-documentor",
  "specification": "ct-spec-writer",
  "validation": "ct-validator",
  "bash-library": "ct-library-implementer-bash",
  "release": "ct-dev-workflow"
}

By Keyword

Keywords	Skill
research, investigate, explore	ct-research-agent
epic, plan, decompose, architect	ct-epic-architect
implement, build, execute, create	ct-task-executor
test, bats, coverage	ct-test-writer-bats
doc, document, readme, guide	ct-documentor
spec, rfc, protocol, contract	ct-spec-writer
validate, verify, audit, compliance	ct-validator
release, version, publish, deploy	ct-dev-workflow

Dispatch Flow

User Request: "research authentication methods"
        │
        ▼
skill_auto_dispatch("T1234")
        │
        ├─1→ Check task labels
        ├─2→ Match keywords ("research" matches)
        ├─3→ skill_dispatch_by_keywords("research authentication")
        │         → returns "ct-research-agent"
        │
        ▼
skill_prepare_spawn("ct-research-agent", "T1234")
        │
        ▼
Spawn cleo-subagent with research protocol injection

Using Skills

Via CLI Command

cleo skills list                          # List installed skills
cleo skills search "query"                # Search local skills
cleo skills search "query" --mp           # Search marketplace (100K+)
cleo skills info ct-orchestrator          # Show skill details
cleo skills install @author/skill --mp    # Install from marketplace
cleo skills installed                     # List marketplace-installed skills
cleo skills update                        # Check for updates

Via Slash Command

/ct-orchestrator     # Invoke orchestrator
/ct-epic-architect   # Plan an epic
/ct-research-agent   # Research a topic

Programmatic Dispatch

# Auto-select skill based on task
protocol=$(skill_auto_dispatch "T1234")

# Prepare spawn with fully-resolved prompt
context=$(skill_prepare_spawn "$protocol" "T1234")

# Spawn cleo-subagent
Task tool: subagent_type="cleo-subagent", prompt=context.prompt

Documentation

Architecture

2-tier design, protocol injection, dispatch algorithm

Manifest Schema

Skill registry format and dispatch matrix

Development

Creating custom skills

SkillsMP

External marketplace integration

Individual Skills

Tier 0-1: Coordination & Planning

Orchestrator

Multi-agent workflow coordination (Tier 0)

Epic Architect

Epic decomposition and planning (Tier 1)

Tier 2: Execution

Task Executor

General implementation workflows

Research Agent

Information gathering and analysis

Spec Writer

Technical specifications with RFC 2119

Test Writer

BATS test creation

Library Implementer

Bash library development

Validator

Compliance and validation checks

Dev Workflow

Git workflow and releases

Tier 3: Support

Documentor

Documentation orchestration

Docs Lookup

Library documentation via Context7

Docs Write

Documentation writing (CLEO style)

Docs Review

Documentation review

Skill Creator

Skill development guide

Skill Lookup

SkillsMP discovery