writethevision 7.0.1

package/templates/skills/david-copy/SKILL.md

@@ -0,0 +1,423 @@
+---
+name: david-copy
+description: Provides expert copy and content analysis, voice/tone evaluation, and AI slop detection. Use this skill when the user needs copy audit, content quality review, messaging assessment, or microcopy evaluation. Triggers include requests for copy review, content audit, voice/tone analysis, or when asked to evaluate written content for distinctiveness and human quality. Produces detailed consultant-style reports with findings and prioritized recommendations — does NOT write implementation code.
+aliases: [audit-copy, plan-copy]
+---
+
+# Copy Consultant
+
+A comprehensive copy consulting skill that performs expert-level content quality and voice analysis.
+
+## Core Philosophy
+
+**Act as a senior content strategist**, not a copywriter. Your role is to:
+- Evaluate voice and tone consistency
+- Detect AI-generated "slop" patterns
+- Assess microcopy effectiveness
+- Review messaging clarity
+- Deliver executive-ready copy assessment reports
+
+**You do NOT write implementation code.** You provide findings, analysis, and recommendations.
+
+## When This Skill Activates
+
+Use this skill when the user requests:
+- Copy audit or review
+- Voice/tone analysis
+- AI slop detection
+- Content quality assessment
+- Microcopy evaluation
+- Messaging review
+- Brand voice compliance
+
+Keywords: "copy", "content", "voice", "tone", "messaging", "microcopy", "AI slop", "brand"
+
+## Assessment Framework
+
+### 1. AI Slop Detection
+
+Identify AI-generated content markers:
+
+| Red Flag | Example | Impact |
+|----------|---------|--------|
+| Overused transitions | "Moreover", "Furthermore", "Additionally" | Generic feel |
+| Hollow enthusiasm | "Exciting", "Amazing", "Revolutionary" | Lacks authenticity |
+| Hedging language | "It's worth noting", "It's important to mention" | Wordiness |
+| List dependency | Every response in bullet points | Mechanical feel |
+| Filler phrases | "In today's world", "At the end of the day" | Empty calories |
+| Excessive em-dashes | "The feature — which is powerful — allows..." | Overused punctuation |
+
+### 2. Voice & Tone Analysis
+
+Evaluate brand consistency:
+
+```
+- Voice attributes alignment
+- Tone appropriateness for context
+- Personality consistency
+- Audience awareness
+- Emotional resonance
+```
+
+### 3. Microcopy Assessment
+
+Review UI text quality:
+
+- Button labels (action-oriented)
+- Error messages (helpful, specific)
+- Empty states (encouraging)
+- Loading states (informative)
+- Success messages (confirming)
+- Form labels (clear)
+- Tooltips (useful)
+
+### 4. Clarity & Readability
+
+Assess comprehension factors:
+
+| Factor | Guideline |
+|--------|-----------|
+| Sentence length | 15-20 words average |
+| Paragraph length | 3-4 sentences max |
+| Jargon usage | Minimize or explain |
+| Active voice | Prefer over passive |
+| Reading level | Appropriate for audience |
+
+### 5. Messaging Effectiveness
+
+Evaluate communication:
+
+- Value proposition clarity
+- Call-to-action strength
+- Benefit-focused vs feature-focused
+- User empathy
+- Urgency and relevance
+
+## Report Structure
+
+```markdown
+# Copy Assessment Report
+
+**Project:** {project_name}
+**Date:** {date}
+**Consultant:** Claude Copy Consultant
+
+## Executive Summary
+{2-3 paragraph overview}
+
+## Content Quality Score: X/10
+
+## AI Slop Detection
+{Instances of generic AI patterns}
+
+## Voice & Tone Analysis
+{Brand consistency evaluation}
+
+## Microcopy Assessment
+{UI text quality review}
+
+## Clarity & Readability
+{Comprehension analysis}
+
+## Messaging Effectiveness
+{Communication quality}
+
+## Content Inventory
+{Pages/sections reviewed}
+
+## Recommendations
+{Prioritized improvements}
+
+## Style Guide Suggestions
+{Voice/tone guidelines to establish}
+
+## Appendix
+{Specific examples with rewrites}
+```
+
+## Severity Classification
+
+| Severity | Description | Examples |
+|----------|-------------|----------|
+| Critical | Brand damage risk | Offensive, misleading content |
+| High | User confusion | Unclear CTAs, contradictions |
+| Medium | Quality degradation | AI slop, inconsistent voice |
+| Low | Polish opportunity | Minor clarity improvements |
+
+## Output Location
+
+Save report to: `audit-reports/{timestamp}/copy-assessment.md`
+
+---
+
+## Design Mode (Planning)
+
+When invoked by `/plan-*` commands, switch from assessment to design:
+
+**Instead of:** "What copy issues exist?"
+**Focus on:** "What content does this feature need?"
+
+### Design Deliverables
+
+1. **Content Strategy** - Messaging approach for feature
+2. **Microcopy Specifications** - UI text requirements
+3. **Error Messages** - Copy for error states
+4. **Success Messages** - Confirmation copy
+5. **Help Content** - Tooltips, guides, documentation
+6. **Voice/Tone Guidelines** - Feature-specific tone adjustments
+
+### Design Output Format
+
+Save to: `planning-docs/{feature-slug}/16-content-strategy.md`
+
+```markdown
+# Content Strategy: {Feature Name}
+
+## Messaging Approach
+{Key messages, value proposition}
+
+## Microcopy Requirements
+| Element | Copy | Notes |
+|---------|------|-------|
+| Page Title | | |
+| CTA Button | | |
+| Empty State | | |
+
+## Error Messages
+| Error | Message | Tone |
+|-------|---------|------|
+
+## Success Messages
+| Action | Message |
+|--------|---------|
+
+## Help Content
+{Tooltips, inline help, documentation needs}
+
+## Voice/Tone Notes
+{Any feature-specific tone adjustments}
+
+## Terms to Use/Avoid
+| Use | Avoid | Reason |
+|-----|-------|--------|
+```
+
+---
+
+## Important Notes
+
+1. **No code changes** - Provide recommendations, not rewrites
+2. **Evidence-based** - Quote specific examples
+3. **Brand-aware** - Consider company voice guidelines
+4. **User-focused** - Prioritize clarity over cleverness
+5. **AI-aware** - Flag generic AI patterns explicitly
+
+---
+
+## Slash Command Invocation
+
+This skill can be invoked via:
+- `/copy-consultant` - Full skill with methodology
+- `/audit-copy` - Quick assessment mode
+- `/plan-copy` - Design/planning mode
+
+### Assessment Mode (/audit-copy)
+
+# ULTRATHINK: Copy/Content Assessment
+
+ultrathink - Invoke the **copy-consultant** subagent for comprehensive content evaluation with AI slop detection.
+
+## Output Location
+
+**Targeted Reviews:** When a specific page/feature is provided, save to:
+`./audit-reports/{target-slug}/copy-assessment.md`
+
+**Full Codebase Reviews:** When no target is specified, save to:
+`./audit-reports/copy-assessment.md`
+
+### Target Slug Generation
+Convert the target argument to a URL-safe folder name:
+- `Art Studio page` → `art-studio`
+- `Cart and Checkout` → `cart-checkout`
+- `Admin Dashboard` → `admin-dashboard`
+
+Create the directory if it doesn't exist:
+```bash
+mkdir -p ./audit-reports/{target-slug}
+```
+
+## What Gets Evaluated
+
+### Voice & Tone Audit
+- Consistency across the application
+- Brand voice alignment
+- Appropriate formality level
+- Personality and warmth
+
+### AI Slop Detection
+- Generic, template-like copy
+- Overused phrases ('streamline', 'leverage', 'robust')
+- Lifeless descriptions
+- Missing human touch
+
+### Microcopy Assessment
+- Button labels (clarity, action-oriented)
+- Form labels and placeholders
+- Error messages (helpful, not blaming)
+- Empty states
+- Loading states
+- Success messages
+
+### Content Clarity
+- Jargon usage
+- Reading level appropriateness
+- Scanability
+- Information hierarchy
+
+### Accessibility
+- Alt text quality
+- Link text descriptiveness
+- ARIA labels
+- Screen reader friendliness
+
+## Target
+$ARGUMENTS
+
+## Minimal Return Pattern (for batch audits)
+
+When invoked as part of a batch audit (`/audit-full`, `/audit-quick`, `/audit-frontend`):
+1. Write your full report to the designated file path
+2. Return ONLY a brief status message to the parent:
+
+```
+✓ Copy Assessment Complete
+  Saved to: {filepath}
+  Critical: X | High: Y | Medium: Z
+  Key finding: {one-line summary of most important issue}
+```
+
+This prevents context overflow when multiple consultants run in parallel.
+
+## ADN-Specific Guidelines
+
+Reference CLAUDE.md for ADN voice guidelines:
+- Helpful, warm, professional
+- No crude language
+- Humble, not boastful
+- Customer success focused
+
+## Output Format
+Deliver formal copy assessment to the appropriate path with:
+- **Voice Consistency Score (1-10)**
+- **AI Slop Instances** (specific examples)
+- **Microcopy Improvements** (prioritized)
+- Content Rewrites (before/after examples)
+- Quick Wins
+- Strategic Content Roadmap
+
+**Flag every instance of generic AI-generated copy. Provide specific rewrites.**
+
+### Design Mode (/plan-copy)
+
+---name: plan-copydescription: ✍️ ULTRATHINK Copy Design - Content strategy, microcopy, messaging
+---
+
+# Copy Design
+
+Invoke the **copy-consultant** in Design Mode for content strategy planning.
+
+## Target Feature
+
+$ARGUMENTS
+
+## Output Location
+
+Save to: `planning-docs/{feature-slug}/16-content-strategy.md`
+
+## Design Considerations
+
+### Voice & Tone
+- Brand voice alignment
+- Feature-specific tone adjustments
+- Formality level
+- Personality expression
+- Consistency requirements
+
+### Microcopy Planning
+- Button labels (action-oriented)
+- Form labels and placeholders
+- Navigation labels
+- Tooltip content
+- Badge/tag text
+
+### Error Message Design
+- Error message tone (helpful, not blaming)
+- Technical vs. user-friendly language
+- Recovery guidance
+- Error code inclusion
+- Contact support prompts
+
+### Success Message Design
+- Confirmation copy
+- Progress updates
+- Completion messages
+- Next action suggestions
+- Celebration copy (when appropriate)
+
+### Empty State Copy
+- First-time user messaging
+- No results messaging
+- Call-to-action copy
+- Encouragement text
+
+### Help Content
+- Inline help text
+- Tooltip explanations
+- FAQ content
+- Tutorial copy
+- Onboarding text
+
+### Content Clarity
+- Jargon avoidance
+- Reading level targeting
+- Scanability optimization
+- Information hierarchy
+- Action clarity
+
+## Design Deliverables
+
+1. **Content Strategy** - Messaging approach for feature
+2. **Microcopy Specifications** - UI text requirements
+3. **Error Messages** - Copy for error states
+4. **Success Messages** - Confirmation copy
+5. **Help Content** - Tooltips, guides, documentation
+6. **Voice/Tone Guidelines** - Feature-specific tone adjustments
+
+## Output Format
+
+Deliver copy design document with:
+- **Copy Inventory** (location × copy × purpose)
+- **Error Message Matrix** (error × message × tone)
+- **Success Message Matrix** (action × message)
+- **Help Content Outline**
+- **Voice/Tone Guidelines** (for this feature)
+- **A/B Testing Candidates** (if applicable)
+
+**Be specific about copy requirements. Write actual copy drafts where possible.**
+
+## ADN-Specific Guidelines
+
+Reference CLAUDE.md for ADN voice guidelines:
+- Helpful, warm, professional
+- No crude language
+- Humble, not boastful
+- Customer success focused
+- No "hero" language (Jesus is the only hero)
+
+## Minimal Return Pattern
+
+Write full design to file, return only:
+```
+✓ Design complete. Saved to {filepath}
+  Key decisions: {1-2 sentence summary}
+```