skills/coach/SKILL.md
Use when Claude makes repeated mistakes, users correct behavior, tool failures indicate missing knowledge, or managing learning via /coach commands.
npx skillsauth add netresearch/claude-coach-plugin coachInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
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.
| 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" |
~/.claude-coach/events.sqlite/coach review approves/rejects/edits~/.claude/CLAUDE.md (global) or repo AGENTS.md (project)/coach retro maps manual work to skill gaps, opens PRs at source repos~/.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
Execute from ${CLAUDE_PLUGIN_ROOT}/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 |
/coach scan — Check for outdated CLI tools and dependencies/coach retro — Session retrospective: analyze manual work, create PRs to improve skills at sourceFor detailed architecture, schemas, and patterns, see references/ directory.
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.