cco-coach

star 53

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

egorfedorov By egorfedorov schedule Updated 5/9/2026

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.

Install via CLI
npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-coach
Repository Details
star Stars 53
call_split Forks 8
navigation Branch main
article Path SKILL.md
More from Creator