@cleocode/ct-skills

cleo-skills

Official skills library for the CLEO ecosystem. A standalone package containing all CLEO-maintained skills, following the Agent Skills Standard.

This repo is designed as a package dependency consumed by CLEO (orchestration) via CAAMP (package management). Skills are agentskills.io-compliant SKILL.md files that CLEO injects as context into subagent spawns.

Architecture

CLEO (orchestrator) ──► CAAMP (install/manage) ──► cleo-skills (this repo)
                                                      ├── skills/         skill content
                                                      ├── _shared/        protocol infrastructure
                                                      ├── manifest.json   CLEO dispatch registry
                                                      └── skills.json     agentskills.io index

Artifact	Consumer	Purpose
skills.json	CAAMP	Install, discover, validate skills
manifest.json	CLEO orchestrator	Dispatch routing, token budgets, chaining
_shared/	CLEO protocol stack	DRY infrastructure injected at spawn time
skills/*/SKILL.md	Subagents	Context injection content

Available Skills

Tier 0 — Orchestration

Skill	Description
ct-orchestrator	Multi-agent workflow coordination with ORC constraints

Tier 1 — Planning

Skill	Description
ct-epic-architect	Epic decomposition, task breakdown, wave planning

Tier 2 — Execution

Skill	Description
ct-task-executor	General implementation task execution
ct-research-agent	Multi-source research and investigation
ct-spec-writer	RFC 2119 technical specification writing
ct-test-writer-bats	BATS integration test creation
ct-library-implementer-bash	Bash library development
ct-validator	Compliance validation and auditing
ct-dev-workflow	Task-driven development workflow and releases
ct-contribution-protocol	Contribution workflow and protocol enforcement

Tier 3 — Specialized

Skill	Description
ct-documentor	Documentation orchestration (lookup → write → review)
ct-docs-lookup	Library documentation lookup via Context7
ct-docs-write	Documentation writing with style guide compliance
ct-docs-review	Documentation review and style checking
ct-skill-creator	Guide for creating new skills
ct-skill-lookup	Skill discovery and marketplace search

Standalone — Universal

Skill	Description
ct-gitbook	GitBook platform guide (no CLEO dependencies)

Installation

Via CAAMP (recommended)

# Install a specific skill
caamp skills install /path/to/cleo-skills/skills/ct-gitbook

# CAAMP handles versioning, validation, and symlink creation

Manual

Copy or symlink a skill directory into your agent's skills location:

# Claude Code
cp -r skills/ct-gitbook ~/.claude/skills/ct-gitbook

# Codex
cp -r skills/ct-gitbook .agents/skills/ct-gitbook

# Copilot (VS Code)
cp -r skills/ct-gitbook .github/skills/ct-gitbook

Project Structure

cleo-skills/
├── skills.json                  # agentskills.io index (auto-generated)
├── manifest.json                # CLEO dispatch registry (manual)
├── scripts/
│   └── build-index.sh           # Validates skills + generates skills.json
├── docs/
│   └── SKILL-SPECIFICATION.md   # Skill authoring guidelines
├── skills/
│   ├── _shared/                 # CLEO protocol infrastructure (not a skill)
│   │   ├── subagent-protocol-base.md
│   │   ├── manifest-operations.md
│   │   ├── task-system-integration.md
│   │   ├── skill-chaining-patterns.md
│   │   ├── testing-framework-config.md
│   │   ├── cleo-style-guide.md
│   │   └── placeholders.json
│   ├── ct-gitbook/              # Skill with references/ and assets/
│   │   ├── SKILL.md
│   │   ├── references/
│   │   └── assets/
│   ├── ct-orchestrator/         # Skill with references/
│   │   ├── SKILL.md
│   │   └── references/
│   └── ct-*/                    # Other skills (SKILL.md only)
└── LICENSE

Adding a New Skill

• Create a directory under skills/ matching your skill name
• Add a SKILL.md with valid YAML frontmatter (name, description required)
• Add references/, scripts/, or assets/ as needed for progressive disclosure
• Add an entry to manifest.json if the skill needs CLEO dispatch routing
• Run the index builder to validate and update skills.json:

bash scripts/build-index.sh

See docs/SKILL-SPECIFICATION.md for the full specification.

Dual Manifest Design

This repo maintains two manifests that serve different consumers:

skills.json (auto-generated) — agentskills.io standard index. CAAMP reads this for installation, discovery, and validation. Contains: name, description, path, references list. Generated by scripts/build-index.sh from SKILL.md frontmatter.

manifest.json (manual) — CLEO dispatch registry. The orchestrator reads this to route tasks to skills. Contains: dispatch triggers, keyword mappings, token budgets, tier levels, chaining rules, capability declarations. This is operational metadata that doesn't belong in the agentskills.io standard.

The shared fields (name, description) both derive from SKILL.md frontmatter — the single source of truth for skill identity.

License

MIT