MCPInstall

coach

by netresearchEducation & Science

Use when Claude makes repeated mistakes, users correct behavior, tool failures indicate missing knowledge, or managing learning via /coach commands.

Installs
83
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/netresearch/claude-coach-plugin --skill coach
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads coach automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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)

  1. COMMAND_FAILURE (Highest) - Non-zero exit, stderr patterns
  2. USER_CORRECTION (High) - Explicit correction language
  3. SKILL_SUPPLEMENT (High) - Additional guidance for a skill
  4. VERSION_ISSUE (Medium-High) - Deprecated/outdated warnings
  5. REPETITION (Medium) - Semantically similar instruction repeated
  6. TONE_ESCALATION (Low) - Frustration indicators

Candidate Types

TypeDescriptionExample
ruleStable constraint"Never edit generated files"
checklistWorkflow step"Run tests after code change"
snippetRepeatable command"Preflight check script"
skillSkill update suggestion"Add X guidance to Y skill"
antipatternThings to never do"Never assume tool exists"

Workflow Summary

  1. Detection — hooks capture events → ~/.claude-coach/events.sqlite
  2. Generation — aggregate signals into proposals (fingerprints dedupe)
  3. Scope — project vs global per path/language
  4. Review — /coach review approves/rejects/edits
  5. Apply — approved rules → ~/.claude/CLAUDE.md (global) or repo AGENTS.md (project)
  6. Retro — /coach retro maps 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/:

ScriptPurpose
init_coach.pyInitialize coach system
detect_signals.pyPattern detection for friction
aggregate.pyTurn signals into candidates
skill_analyzer.pyAnalyze skills and scan for outdated tools
apply.pyApply 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.

FAQ

What does the coach skill do?

Use when Claude makes repeated mistakes, users correct behavior, tool failures indicate missing knowledge, or managing learning via /coach commands.

How do I install coach?

Run npx skills add https://github.com/netresearch/claude-coach-plugin --skill coach in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/coach/ (personal) or .claude/skills/coach/ (project).

Which AI agents can use coach?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is coach safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains coach?

It is published by netresearch in netresearch/claude-coach-plugin. It has 83 recorded installs.

Popular education & science skills

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

scaffold-exercises

mattpocock/skills

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

Education & Science488.2K installs

paper-context-resolver

lllllllama/rigorpilot-skills

Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.

Education & Science478.3K installs

caveman-learn

juliusbrussee/caveman

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Education & Science107.9K installs

gsap-plugins

greensock/gsap-skills

Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.

Education & Science50K installs