claude-skills/engineering/claude-coach
Claude 028dc13b35
feat(tooling): JSON-output sample gate (G9) + --sample fixtures (#654)
Implements issue #654 Option A (embedded-sample convention) plus the
verification harness the issue asked for:

- scripts/smoke_json_output.py — new advisory gate (G9) that discovers
  every tool whose --help advertises JSON output, runs <tool> --sample
  <json-flag>, and asserts the stdout parses as JSON. Tools advertising
  JSON without --sample are reported as 'uncovered' (a backlog, not a
  failure) so the gate can be adopted incrementally; --strict flips that
  to a hard failure once coverage is high. Wired into ci-quality-gate.yml
  alongside G8.
- Added --sample embedded fixtures to the 5 tools named in #654:
  error_budget_calculator, slo_review, blast_radius_calculator,
  audit_log_analyzer, api_linter. Their required args are now optional
  when --sample is passed; missing-arg behavior is unchanged otherwise.
- Fixed 4 tools the new gate surfaced (prompt_rater, coach_tip_classifier,
  cheat_code_filter, redaction_linter): their --sample path printed human
  text and ignored --json; it now honors the JSON flag.
- Synced the 3 dual-published standalone copies (slo-architect x2,
  chaos-engineering) so the drift guard stays green.

Gate now reports 16 tools covered, 16 verified, 0 failures.

https://claude.ai/code/session_01CUWsrUNZP9jpxvAwq67UiT
2026-06-11 15:29:39 +00:00
..
.claude-plugin chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
agents fix: phantom-path sweep — 888 unresolvable references to zero 2026-06-10 14:33:00 +00:00
commands fix: phantom-path sweep — 888 unresolvable references to zero 2026-06-10 14:33:00 +00:00
skills/claude-coach feat(tooling): JSON-output sample gate (G9) + --sample fixtures (#654) 2026-06-11 15:29:39 +00:00
README.md feat(engineering): add claude-coach skill 2026-05-22 05:59:51 +00:00

Claude Coach

A personal coach that teaches you to use Claude at its full capability — without getting in your way.

What it does

  • Teaches — On first use, gives you a personalized cheat-code glossary ranked by impact
  • Coaches — Quietly watches your prompts and surfaces ONE tip per response when it spots an easy win
  • Levels you up — Rates your prompts on request and shows you a better version

Installation

  1. Place the claude-coach/ folder in your skills directory
  2. Start a new conversation
  3. Say one of:
    • "Coach me on Claude"
    • "Teach me the Claude cheat codes"
    • "Make me a Claude power user"

The skill activates and stays on for the rest of the conversation.

Usage

Once activated, just chat normally. The coach will:

  • Stay silent on most turns (that is intentional)
  • Append a Power-user tip at the end of a response when it spots an easy win
  • Rate your prompt when you ask "rate that prompt"
  • Give a progress check when you ask "how am I doing"

To turn it off mid-conversation, say "stop with the tips" and it goes quiet.

Philosophy

Most coaching tools are annoying because they interrupt. This one answers your actual question first, then adds at most one observation. If there is nothing genuinely useful to add, it says nothing.

License

MIT