Initial commit

2025-11-29 18:49:11 +08:00
commit 535c39cb7f
9 changed files with 3642 additions and 0 deletions
--- a/skills/content-brief-generator/SKILL.md
+++ b/skills/content-brief-generator/SKILL.md
@@ -0,0 +1,496 @@
+---
+name: content-brief-generator
+description: Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.
+---
+
+# Content Brief Generator
+
+A comprehensive skill for creating detailed content briefs that guide writers, ensure consistency, and align content with business goals.
+
+## What This Skill Does
+
+Helps you create professional content briefs for:
+- **Blog posts and articles** - Thought leadership, tutorials, how-tos
+- **Technical documentation** - API docs, guides, README files
+- **Marketing copy** - Landing pages, email campaigns, ads
+- **Social media content** - Posts, campaigns, threads
+- **Case studies** - Customer success stories
+- **Whitepapers and reports** - In-depth research content
+- **Product descriptions** - E-commerce and product pages
+- **Video scripts** - YouTube, explainer videos, demos
+
+## Why Content Briefs Matter
+
+**Without a brief:**
+- Unclear expectations and scope
+- Multiple rounds of revisions
+- Inconsistent tone and messaging
+- Missing SEO opportunities
+- Wasted time and resources
+
+**With a brief:**
+- Clear direction and goals
+- Fewer revisions needed
+- Consistent quality
+- SEO-optimized content
+- Efficient workflow
+
+## Core Components of a Content Brief
+
+### 1. Content Overview
+- Title/working title
+- Content type (blog, doc, landing page, etc.)
+- Target audience
+- Primary goal (educate, convert, entertain, etc.)
+- Key message or takeaway
+
+### 2. Audience & Context
+- Target persona
+- Reader's knowledge level
+- Pain points and needs
+- Where they are in the funnel
+- How they'll discover content
+
+### 3. Strategic Elements
+- Business objectives
+- SEO keywords and intent
+- Competitive landscape
+- Success metrics
+- CTAs and conversion goals
+
+### 4. Content Requirements
+- Tone and voice
+- Length/word count
+- Structure and sections
+- Research requirements
+- Visual/media needs
+
+### 5. SEO & Distribution
+- Primary and secondary keywords
+- Search intent
+- Meta description
+- Internal/external links
+- Distribution channels
+
+## Content Types & Templates
+
+### Blog Post Brief
+**Use for:** Thought leadership, tutorials, listicles, how-tos
+
+**Key elements:**
+- Hook and introduction angle
+- Main points (typically 3-7)
+- Examples and data to include
+- Call-to-action
+- Internal linking strategy
+
+### Technical Documentation Brief
+**Use for:** API docs, guides, developer documentation
+
+**Key elements:**
+- Technical accuracy requirements
+- Code examples needed
+- Audience technical level
+- Prerequisites
+- Related documentation
+
+### Landing Page Brief
+**Use for:** Product pages, signup pages, campaign pages
+
+**Key elements:**
+- Value proposition
+- Benefits vs. features
+- Social proof requirements
+- Conversion goal
+- A/B testing plan
+
+### Case Study Brief
+**Use for:** Customer success stories, testimonials
+
+**Key elements:**
+- Customer background
+- Problem/solution/results framework
+- Metrics and outcomes
+- Quotes needed
+- Industry context
+
+## Content Structure Frameworks
+
+### AIDA (Attention, Interest, Desire, Action)
+**Best for:** Marketing copy, sales pages
+
+1. **Attention:** Grab with headline
+2. **Interest:** Build with benefits
+3. **Desire:** Create want with proof
+4. **Action:** Drive with clear CTA
+
+### PAS (Problem, Agitate, Solve)
+**Best for:** Blog posts, email campaigns
+
+1. **Problem:** Identify pain point
+2. **Agitate:** Emphasize urgency
+3. **Solve:** Present solution
+
+### Inverted Pyramid
+**Best for:** News, technical docs
+
+1. Most important info first
+2. Supporting details
+3. Background context
+
+### Storytelling Arc
+**Best for:** Case studies, narratives
+
+1. Setup (character/situation)
+2. Conflict (challenge)
+3. Resolution (solution)
+4. Takeaway (lesson)
+
+## SEO Integration
+
+### Keyword Strategy
+- Primary keyword (1)
+- Secondary keywords (2-3)
+- Long-tail variations (3-5)
+- LSI keywords (related terms)
+
+### Search Intent
+- **Informational:** Learn about something
+- **Navigational:** Find specific page
+- **Commercial:** Compare options
+- **Transactional:** Ready to buy
+
+### On-Page SEO
+- Title tag (include primary keyword)
+- Meta description (compelling + keyword)
+- Headers (H1, H2, H3 with keywords)
+- Image alt text
+- Internal linking
+
+## Tone & Voice Guidelines
+
+### Tone Spectrum
+- **Formal ↔ Casual**
+- **Serious ↔ Playful**
+- **Respectful ↔ Irreverent**
+- **Enthusiastic ↔ Matter-of-fact**
+
+### Voice Attributes
+Define your brand voice:
+- **Professional but approachable** (like Stripe)
+- **Technical but friendly** (like Twilio)
+- **Playful and bold** (like Mailchimp)
+- **Authoritative and trustworthy** (like HubSpot)
+
+### Writing Style
+- Active vs. passive voice
+- Person (1st, 2nd, 3rd)
+- Sentence length
+- Paragraph structure
+- Use of jargon
+
+## Research & Sourcing
+
+### Research Requirements
+- **Primary research:** Interviews, surveys, original data
+- **Secondary research:** Industry reports, competitor analysis
+- **Expert quotes:** SME interviews, third-party experts
+- **Data and statistics:** Credible sources, recent data
+- **Examples:** Real-world cases, screenshots
+
+### Citation Standards
+- Link to original sources
+- Attribute quotes
+- Recent data (within 1-2 years)
+- Authoritative sources
+- Fact-checking requirements
+
+## Visual & Media Requirements
+
+### Images
+- Hero image specifications
+- In-content images (how many, what type)
+- Screenshots or diagrams
+- Charts or infographics
+- Alt text requirements
+
+### Video/Audio
+- Video length and format
+- Screen recordings needed
+- B-roll requirements
+- Audio quality standards
+
+### Other Media
+- Code snippets
+- Downloadable resources
+- Interactive elements
+- Embedded content
+
+## Workflow & Process
+
+### 1. Brief Creation (This Skill)
+Use `generate_brief.sh` to create comprehensive brief
+
+### 2. Research & Outline
+Writer researches and creates outline
+
+### 3. First Draft
+Writer creates content following brief
+
+### 4. Review & Edit
+Editor reviews against brief requirements
+
+### 5. SEO Optimization
+SEO review and optimization
+
+### 6. Final Approval
+Stakeholder sign-off
+
+### 7. Publication
+Publish and distribute
+
+### 8. Performance Tracking
+Monitor metrics defined in brief
+
+## Success Metrics by Content Type
+
+### Blog Post
+- Organic traffic
+- Time on page (3+ minutes)
+- Scroll depth
+- Social shares
+- Backlinks
+- Lead generation
+
+### Technical Documentation
+- Page views
+- Time on page
+- Search rankings
+- Feedback ratings
+- Support ticket reduction
+
+### Landing Page
+- Conversion rate
+- Bounce rate
+- Time on page
+- Click-through rate
+- Form submissions
+
+### Case Study
+- Downloads
+- Leads generated
+- Sales pipeline influence
+- Share rate
+
+## Common Content Brief Mistakes
+
+### ❌ Avoid These
+
+**Too Vague:**
+"Write about our product"
+→ No clear audience, goal, or angle
+
+**No Research:**
+Missing competitor analysis and keyword research
+→ Content won't rank or differentiate
+
+**Unclear Voice:**
+"Make it engaging"
+→ Not specific enough for consistency
+
+**Missing CTAs:**
+No clear next step for readers
+→ Missed conversion opportunities
+
+**Ignoring SEO:**
+No keyword strategy
+→ Content won't be discovered
+
+### ✅ Do This Instead
+
+**Specific:**
+"Write 1500-word tutorial for junior developers on JWT authentication, including code examples in Node.js"
+
+**Research-Backed:**
+"Target keyword 'JWT authentication tutorial' (2.4K monthly searches), compete with existing articles from Auth0 and FreeCodeCamp"
+
+**Clear Voice:**
+"Technical but approachable - explain like a senior dev mentoring a junior, use examples, avoid jargon"
+
+**Action-Oriented:**
+"CTA: Sign up for free API key, secondary: Join Discord community"
+
+**SEO-Optimized:**
+"Primary: 'JWT authentication', Secondary: 'JSON web token Node.js', 'secure API authentication'"
+
+## Using This Skill
+
+### Generate a Content Brief
+
+```bash
+./scripts/generate_brief.sh
+```
+
+Interactive workflow will guide you through:
+1. Content type and audience
+2. Goals and objectives
+3. SEO requirements
+4. Structure and requirements
+5. Success metrics
+
+### Validate a Brief
+
+```bash
+./scripts/validate_brief.sh path/to/brief.md
+```
+
+Checks for:
+- Required sections present
+- Keyword strategy defined
+- Target audience specified
+- Success metrics included
+- Completeness score
+
+### Access Templates
+
+```
+references/content_brief_template.md - Complete template
+references/seo_guidelines.md - SEO best practices
+references/content_frameworks.md - Structure frameworks
+references/tone_voice_guide.md - Voice guidelines
+```
+
+## Content Brief Checklist
+
+- [ ] **Clear title** and content type
+- [ ] **Target audience** defined with persona details
+- [ ] **Primary goal** and business objective
+- [ ] **Keyword research** completed
+- [ ] **Search intent** identified
+- [ ] **Tone and voice** specified
+- [ ] **Word count** target
+- [ ] **Structure** and key sections outlined
+- [ ] **Research sources** identified
+- [ ] **Examples** and data requirements
+- [ ] **Visual needs** specified
+- [ ] **CTAs** defined
+- [ ] **Success metrics** established
+- [ ] **Competitor content** analyzed
+- [ ] **Distribution plan** outlined
+
+## Quick Start Examples
+
+### "Create a blog post brief"
+System generates comprehensive brief with:
+- SEO keyword strategy
+- Audience targeting
+- Structure recommendations
+- Success metrics
+
+### "Write technical documentation brief for API"
+System creates technical brief with:
+- Technical requirements
+- Code example specifications
+- Audience skill level
+- Documentation standards
+
+### "Generate landing page brief"
+System builds conversion-focused brief with:
+- Value proposition guidance
+- CTA strategy
+- A/B testing recommendations
+- Conversion metrics
+
+## Best Practices
+
+### 1. Start With Research
+- Analyze top-ranking content
+- Understand search intent
+- Identify content gaps
+- Review competitor approach
+
+### 2. Be Specific
+- Exact word count
+- Specific examples needed
+- Clear tone guidelines
+- Defined success metrics
+
+### 3. Align With Strategy
+- Connect to business goals
+- Fit content calendar
+- Support funnel stage
+- Match brand voice
+
+### 4. Make It Actionable
+- Clear deliverables
+- Specific requirements
+- Concrete examples
+- Measurable outcomes
+
+### 5. Iterate and Improve
+- Track performance
+- Update based on results
+- Refine over time
+- Learn from top performers
+
+## Integration With Other Workflows
+
+### Content Calendar
+Brief creation triggers calendar entry
+
+### SEO Tools
+Keywords from SEMrush, Ahrefs, etc.
+
+### Project Management
+Brief becomes Jira/Asana task
+
+### CMS
+Brief exported to content management system
+
+### Analytics
+Success metrics tracked in dashboards
+
+## Tips for Different Writer Types
+
+### Content Writers
+- Focus on audience and storytelling
+- Emphasize research requirements
+- Clear brand voice guidelines
+
+### Technical Writers
+- Specify technical accuracy needs
+- Define audience knowledge level
+- Include code example requirements
+
+### Copywriters
+- Highlight conversion goals
+- Specify A/B testing needs
+- Clear CTA strategy
+
+### Content Marketers
+- Connect to funnel stage
+- Define distribution strategy
+- Specify lead generation goals
+
+## Resources
+
+All reference materials included:
+- Complete content brief template
+- SEO optimization guidelines
+- Content structure frameworks
+- Tone and voice development guide
+- Copywriting formulas and examples
+
+## Summary
+
+Content briefs ensure:
+- **Clarity** - Everyone knows expectations
+- **Efficiency** - Fewer revisions needed
+- **Quality** - Consistent, strategic content
+- **Results** - Content that achieves goals
+
+Use this skill to create comprehensive briefs that guide writers to success.
+
+---
+
+**Remember:** Time spent on a good brief saves 10x time in revisions. Get it right before writing begins.