/cco-coach

name: cco-coach
description: Analyze the user's last prompt for clarity, scope and specificity — give a quality score and concrete suggestions to make the next prompt produce better results
license: MIT
allowed-tools: [Bash, Read]

Prompt Coach

When the user runs `/cco-coach` or asks for "prompt feedback" / "оцени мой промпт", run the analyzer on the user's last natural-language ask (or on text they provide).

How to use

If the user passes text after the command (e.g. `/cco-coach add login screen`):

node ${CLAUDE_PLUGIN_ROOT}/src/prompt-coach.js analyze "the prompt text here"

If no text given, show recent prompt history and average score:

node ${CLAUDE_PLUGIN_ROOT}/src/prompt-coach.js history 10

What the score means

The coach grades on four dimensions (S/A/B/C/D/F):

• **Specificity** — does the prompt name files, line numbers, identifiers?
• **Scope** — is the change bounded? "fix bug in src/auth.js:42" beats "fix all bugs"
• **Success criteria** — how do we know it's done? (tests pass, error gone, etc.)
• **Length** — too short usually means under-specified; too long buries the ask

Presentation

After running the script, summarise the top 1–3 suggestions in plain language and offer to **rewrite the prompt** for the user. If they say yes:

node ${CLAUDE_PLUGIN_ROOT}/src/prompt-coach.js improve "the original prompt"

Then show the improved version with a brief diff explaining what changed.

When to suggest this proactively

If you notice the user's prompt scored ≤60 in the last UserPromptSubmit hook and a task is going off the rails (lots of reads with no edits), gently suggest `/cco-coach` to refine.