coach
Use when Claude makes repeated mistakes, users correct behavior, tool failures indicate missing knowledge, or managing learning via /coach commands.
How do I install this agent skill?
npx skills add https://github.com/netresearch/claude-coach-plugin --skill coachIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill implements a self-improving learning system that captures agent 'friction' (corrections, failures, etc.) to suggest rules and workflow improvements. It performs system-level operations including modifying agent configuration files and executing shell commands for git and package management. The system includes a 'self-healing' mechanism for hooks to ensure persistent execution across agent sessions.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
1/1 file flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Coach - Self-Improving Learning System
Coach enables Claude to learn from friction and improve over time. It detects learning opportunities (user corrections, repeated instructions, tool failures, tone escalation), extracts actionable improvement candidates, and proposes changes requiring explicit user approval.
Core Principle: No silent writes. All improvements require user approval via /coach approve.
Activation Triggers
Activate when: user corrections ("no", "stop", "don't"), repeated instructions, tool/command failures, tone escalation (ALL CAPS, "!!!"), skill supplements ("also remember..."), deprecated-tool warnings, explicit /coach commands, or session end.
Signal Categories (Priority Order)
- COMMAND_FAILURE (Highest) - Non-zero exit, stderr patterns
- USER_CORRECTION (High) - Explicit correction language
- SKILL_SUPPLEMENT (High) - Additional guidance for a skill
- VERSION_ISSUE (Medium-High) - Deprecated/outdated warnings
- REPETITION (Medium) - Semantically similar instruction repeated
- TONE_ESCALATION (Low) - Frustration indicators
Candidate Types
| Type | Description | Example |
|---|---|---|
rule | Stable constraint | "Never edit generated files" |
checklist | Workflow step | "Run tests after code change" |
snippet | Repeatable command | "Preflight check script" |
skill | Skill update suggestion | "Add X guidance to Y skill" |
antipattern | Things to never do | "Never assume tool exists" |
Workflow Summary
- Detection — hooks capture events →
~/.claude-coach/events.sqlite - Generation — aggregate signals into proposals (fingerprints dedupe)
- Scope — project vs global per path/language
- Review —
/coach reviewapproves/rejects/edits - Apply — approved rules →
~/.claude/CLAUDE.md(global) or repoAGENTS.md(project) - Retro —
/coach retromaps manual work to skill gaps, opens PRs at source repos
File Locations
~/.claude-coach/
├── events.sqlite # Raw friction events
├── candidates.json # Pending proposals
└── ledger.sqlite # Cross-repo fingerprints
~/.claude/CLAUDE.md # Global rules destination
<repo>/AGENTS.md # Project rules destination
~/.claude/ or <repo>/.claude/
├── checklists/ # Workflow checklists
└── snippets/ # Reusable commands
Scope
Coach: live in-session signal — events.sqlite capture, /coach commands.
retro: session-end / cross-session analysis, skill-PR routing. /coach retro overlaps retro's job; merging them is an open decision.
Scripts
scripts/ (this dir) — self-contained for skill-dir installs. Plugin path:
${CLAUDE_PLUGIN_ROOT}/skills/coach/scripts/:
| Script | Purpose |
|---|---|
init_coach.py | Initialize coach system |
detect_signals.py | Pattern detection for friction |
aggregate.py | Turn signals into candidates |
skill_analyzer.py | Analyze skills and scan for outdated tools |
apply.py | Apply approved proposals |
Proactive Commands
/coach scan— Check for outdated CLI tools and dependencies/coach retro— Session retrospective: analyze manual work, create PRs to improve skills at source
For detailed architecture, schemas, and patterns, see references/ directory.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/netresearch/claude-coach-plugin/coach">View coach on skillZs</a>