feat: add cao-provider skill for new CLI agent providers#154
Merged
Conversation
Comprehensive skill with annotated template, 10 lessons learned from building 7 providers, test guide, and step-by-step implementation checklist. Placed in skills/ (not .claude/) so it's tool-agnostic for any AI assistant. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…dation, and README docs - Rename lessons-learned.md to lessons-learnt.md - Add 7 new lessons (#14-#20): shell warm-up, TERM compatibility, alt-screen vs scrollback, startup prompt loop, stale permission detection, per-directory locks, assign+handoff e2e validation - Add docs/tool-restrictions.md as essential reading reference - Add assign+handoff orchestration step (Step 9) to SKILL.md with troubleshooting guide referencing examples/assign/ - Add alt-screen vs scrollback to "Before You Start" checklist - Expand Step 6 with cross-references to lessons #14, #15, #17 - Fix stale lessons-learned.md reference in provider-template.md - Add Skills section to README with tool compatibility table (Claude Code, Kiro CLI, Gemini CLI, Strands Agents SDK, Microsoft Agent Framework, etc.) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The launch commands in lesson #20 and SKILL.md Step 9 were missing --provider (defaults to kiro_cli otherwise) and --auto-approve/--yolo flags needed for new provider testing. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ss criteria Detail each test across 5 suites (handoff, assign, send_message, allowed_tools, supervisor_orchestration) with what it validates and why it matters. Emphasize that all 11 must pass — a supervisor that silently does workers' jobs or ignores tool restrictions is only caught by the full suite. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
fanhongy
approved these changes
Apr 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
cao-providerskill — a portable, structured guide (SKILL.md format) that walks any AI coding assistant through building a new CAO provider end-to-end: ProviderType enum, provider class with regex patterns and status detection, ProviderManager registration, tool restriction wiring, unit/e2e tests, and documentationreferences/provider-template.md) and comprehensive test guide (references/test-guide.md) as progressive-disclosure reference filesWhat's included
skills/cao-provider/SKILL.mdskills/cao-provider/references/lessons-learnt.mdskills/cao-provider/references/provider-template.mdskills/cao-provider/references/test-guide.mdREADME.mdKey design decisions
references/examples/assign/multi-agent flow (supervisor → 3x data analyst + 1x report generator)docs/tool-restrictions.mdas essential reading for tool restriction wiring