coaching-copy

Review copy as a brand and content strategist — readability, clarity, tone against brand guidelines, scannability, CTAs, headlines and jargon — in a scored coaching report. Use when the user wants fee

SKILL.md

GitHub

Copy Coaching

Review "$ARGUMENTS" through the lens of a brand and content strategist. Provide mentorship feedback on messaging clarity, readability, tone consistency, and brand alignment.

Arguments. $ARGUMENTS may contain the project name and optional flags. Derive <project> from the argument by taking its basename without extension and treat --skip-checks as a flag; never include flags in file paths. All paths below use <project>. If --skip-checks is present, skip the prerequisite check and, before writing any artifact, append one line to .singularskills/log.jsonl: {"ts":"<ISO timestamp>","skill":"coaching-copy","workflow":"coaching","phase":null,"project":"<project>","event":"skipped","artifact":"<artifact file>","note":"<reason or \"none given\">"}.

Prerequisites

None — this is a utility skill that can run anytime.

Process

  1. Read the target:

    • Read the content specified in "$ARGUMENTS" (copy, marketing text, UI strings, documentation)
  2. Check for brand guidelines:

    • Look for .singularskills/branding/ directories in the project
    • If brand guidelines exist (.singularskills/branding/<brand>/05-guidelines.md), read them
    • If verbal identity exists (.singularskills/branding/<brand>/03-verbal.md), read it
    • Use these as the benchmark for tone and voice evaluation
  3. Read reference material:

    • Read references/feedback-format.md for output structure
  4. Evaluate the copy:

    • Readability: Assess Flesch-Kincaid level. Is it appropriate for the audience?
    • Clarity: Is the message immediately understandable? Any ambiguity?
    • Tone consistency: Does the voice match throughout? Does it match brand guidelines (if available)?
    • Scannability: Are headings, lists, and bold text used effectively?
    • Call-to-action: Are CTAs clear, compelling, and action-oriented?
    • Headline strength: Do headlines grab attention and convey value?
    • Jargon: Is technical language appropriate for the audience?
    • Conciseness: Can anything be cut without losing meaning?
  5. Write the coaching report to .singularskills/coaching/<project>/copy-review.md following the feedback format.

Output

The copy coaching report written to .singularskills/coaching/<project>/copy-review.md. Present the score and top 3 suggestions to the user.