reflection-coach

Analyzes an agent's execution record and proposes minimal evidence-backed instruction or skill changes.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/nabitllc/todero --skill reflection-coach-nabitllc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflection-coach
Source: https://github.com/nabitllc/todero/tree/main/packages/skills-catalog/catalog/bundled/todero-operations/reflection-coach
Command: npx skills add https://github.com/nabitllc/todero --skill reflection-coach-nabitllc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents repeat the same mistakes because nobody systematically reviews their execution history and converts failure patterns into durable instruction improvements. This Skill turns an agent's recent issue history into reviewed, evidence-backed coaching proposals instead of ad-hoc rewrites. ## Core Features & Use Cases - Trajectory-Based Failure Clustering: Pulls an agent's recent issues and comments via the Todero API, then clusters failures into a named taxonomy (verifier-miss, stale-context, late-escalation, and more) with at least two quoted evidence tuples per cluster. - Minimal Diff Proposals: Routes each cluster to the right surface — AGENTS.md updates capped at +20% growth, reusable skills capped at 15KB, or tool descriptions capped at 500 characters — and drafts the actual diffs and SKILL.md files. - Gated Application: Publishes proposals on a reflection issue with a request_confirmation interaction showing the diff; changes are applied only in a separate follow-up run after acceptance, never hot-swapped. - Use Case: A manager notices an engineer agent repeatedly marks issues done without re-running failing tests. Run this Skill against that agent to get a replay-benchmarked proposal adding one verification rule to its AGENTS.md, gated behind human approval. ## Quick Start Ask the agent to reflect on target agent <agentId> over the last 10 closed issues and produce a coaching proposal with diffs for review.

Frequently Asked Questions about reflection-coach

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an AI agent's past performance and improve its instructions?

Run the reflection-coach Skill with a targetAgentId and a time window or issue count. It pulls the agent's recent issues and comments, clusters failure patterns with quoted evidence, and drafts a minimal diff proposal for the agent's AGENTS.md, skills, or tool descriptions.

How does reflection-coach apply changes to an agent's AGENTS.md?

It never applies changes in the discovery run. The proposal is published with a request_confirmation interaction showing the diff, and only after acceptance is the change applied in a separate follow-up run using server-enforced mutation target keys.

Can an agent use reflection-coach to improve itself?

No. Self-reflection is explicitly refused: if targetAgentId equals the running agent's own PAPERCLIP_AGENT_ID, the Skill exits and asks for a different coach. Coaching must come from a separate agent.

What limits exist on proposed instruction changes?

AGENTS.md may grow by at most 20 percent per proposal, skills are capped at 15KB, and tool descriptions at 500 characters. Every rule must cite at least two concrete evidence tuples from the target's record and pass a replay check against past successful issues.

When should I not use reflection-coach?

Do not use it to rewrite product code or shared infrastructure, to coach yourself, or to apply changes directly without a reviewed diff and accepted interaction. It only targets an agent's own instructions, skills, and tool descriptions.