Commit Graph

3 Commits

Author SHA1 Message Date
Alireza Rezvani
1735ddd371 fix(skill): improve content-creator documentation and add examples (#68) (#129)
- Add TOC to SKILL.md and all reference files
- Move Performance Metrics to new analytics_guide.md reference
- Fix second-person voice to imperative throughout
- Consolidate script documentation (remove duplication)
- Add examples/ directory with brand voice and SEO samples
- Add comprehensive analytics_guide.md with KPIs and reporting

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 09:34:24 +01:00
Reza Rezvani
3ade3b7840 refactor: enhance 3 marketing skills with Anthropic best practices (Phase 1)
Apply Anthropic's official Agent Skills specification to all marketing skills
by adding professional metadata and keywords for better discovery.

Changes Applied to All 3 Marketing Skills:

1. **Enhanced Metadata** (Following Anthropic Spec):
   - Added license: MIT
   - Added version: 1.0.0 (semantic versioning)
   - Added author: Alireza Rezvani
   - Added category: marketing
   - Added domain: [content-marketing|demand-generation|product-marketing]
   - Added updated: 2025-10-20
   - Added python-tools: [specific tools for each skill]
   - Added tech-stack: Platform and tool specifications

2. **Improved Descriptions**:
   - More concise (1-2 sentences what it does)
   - Explicit "Use when..." triggers
   - Added keyword mentions ("or when user mentions...")
   - Better Claude activation cues

3. **Added Keywords Sections**:
   - Comprehensive keyword lists for discovery
   - User-facing terms (what they would actually say)
   - SEO-friendly for documentation
   - Helps Claude and users find the right skill

Specific Updates:

**content-creator:**
- Added 11 metadata fields
- Added 17 discovery keywords
- Enhanced description with explicit triggers
- Clearer focus: SEO-optimized content with brand voice

**marketing-demand-acquisition:**
- Added 13 metadata fields (includes target-market)
- Added 22 discovery keywords
- Enhanced description with channel specifics
- Added tech-stack details (HubSpot, LinkedIn, Google, Meta)

**marketing-strategy-pmm:**
- Added 12 metadata fields (includes frameworks)
- Added 21 discovery keywords
- Enhanced description with PMM specifics
- Added framework references (April Dunford, ICP)

Impact:
- Better skill discovery (keywords + enhanced descriptions)
- Professional metadata (version tracking, licensing)
- Clearer activation triggers for Claude
- Maintained all existing expertise and content

This is Phase 1 of systematic refactoring following:
documentation/implementation/SKILLS_REFACTORING_PLAN.md

Next: Phase 2 will optimize SKILL.md lengths (reduce by 50%)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-20 23:54:57 +02:00
Reza Rezvani
4a4a3160f3 feat: initialize marketing skills repository with content-creator skill
Add comprehensive content-creator skill package including:
- Brand voice analyzer (Python CLI tool)
- SEO optimizer with scoring and recommendations
- Brand guidelines with 5 personality archetypes
- 15+ content frameworks and templates
- Platform-specific social media optimization guides
- Content calendar template
- Marketing skills roadmap for future expansion

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-19 06:05:42 +02:00