|
| 1 | +# Marketing Skill - Directory Structure & Quick Reference |
| 2 | + |
| 3 | +## Complete Directory Structure |
| 4 | + |
| 5 | +``` |
| 6 | +marketing-skill/ |
| 7 | +│ |
| 8 | +├── SKILL.md ← Main skill file (START HERE) |
| 9 | +├── README.md ← Overview and quick start guide |
| 10 | +├── IMPLEMENTATION_GUIDE.md ← Deployment and customization checklist |
| 11 | +├── DIRECTORY_STRUCTURE.md ← This file |
| 12 | +│ |
| 13 | +├── reference/ ← Core reference materials (one level deep from SKILL.md) |
| 14 | +│ ├── campaigns.md ← Campaign planning frameworks & templates |
| 15 | +│ ├── content.md ← Content creation & copywriting guidelines |
| 16 | +│ ├── social_media.md ← Platform-specific social strategies |
| 17 | +│ ├── email.md ← Email marketing best practices & templates |
| 18 | +│ ├── analytics.md ← Analytics frameworks & KPI definitions |
| 19 | +│ ├── brand.md ← Brand voice, visual standards, guidelines |
| 20 | +│ └── templates.md ← Ready-to-use marketing templates |
| 21 | +│ |
| 22 | +├── scripts/ ← Executable utility scripts |
| 23 | +│ └── marketing_utils.py ← Campaign tracking & UTM parameter generator |
| 24 | +│ (Run: python marketing_utils.py --help) |
| 25 | +│ |
| 26 | +├── examples/ ← Sample files for reference |
| 27 | +│ └── campaigns_sample.csv ← Sample CSV for batch URL generation |
| 28 | +│ |
| 29 | +└── [After customization, you may add]: |
| 30 | + ├── company-templates/ ← Your company-specific templates |
| 31 | + ├── success-stories/ ← Documented successful campaigns |
| 32 | + ├── brand-assets/ ← Brand guidelines, logos, colors |
| 33 | + └── internal-docs/ ← Your company process docs |
| 34 | +``` |
| 35 | + |
| 36 | +### File Relationships |
| 37 | + |
| 38 | +``` |
| 39 | +SKILL.md (Entry point) |
| 40 | + │ |
| 41 | + ├─→ reference/campaigns.md |
| 42 | + │ ├─ For: Campaign planning, strategy, ROI calculation |
| 43 | + │ ├─ Use when: Planning a new campaign |
| 44 | + │ └─ Contains: Templates, frameworks, examples |
| 45 | + │ |
| 46 | + ├─→ reference/content.md |
| 47 | + │ ├─ For: Copywriting, messaging, content strategy |
| 48 | + │ ├─ Use when: Creating marketing content |
| 49 | + │ └─ Contains: Formulas, guidelines, examples |
| 50 | + │ |
| 51 | + ├─→ reference/social_media.md |
| 52 | + │ ├─ For: Platform strategies, best practices |
| 53 | + │ ├─ Use when: Planning social campaigns |
| 54 | + │ └─ Contains: Platform guides, metrics, tactics |
| 55 | + │ |
| 56 | + ├─→ reference/email.md |
| 57 | + │ ├─ For: Email marketing, sequences, deliverability |
| 58 | + │ ├─ Use when: Creating email campaigns |
| 59 | + │ └─ Contains: Templates, segmentation, metrics |
| 60 | + │ |
| 61 | + ├─→ reference/analytics.md |
| 62 | + │ ├─ For: KPIs, measurement, attribution |
| 63 | + │ ├─ Use when: Setting up measurement, analyzing performance |
| 64 | + │ └─ Contains: Frameworks, KPI definitions, reporting |
| 65 | + │ |
| 66 | + ├─→ reference/brand.md |
| 67 | + │ ├─ For: Voice, tone, visual standards |
| 68 | + │ ├─ Use when: Ensuring brand consistency |
| 69 | + │ └─ Contains: Guidelines, standards, examples |
| 70 | + │ |
| 71 | + ├─→ reference/templates.md |
| 72 | + │ ├─ For: Ready-to-use templates for all channels |
| 73 | + │ ├─ Use when: Need to quickly create content |
| 74 | + │ └─ Contains: Email, landing page, social, ad templates |
| 75 | + │ |
| 76 | + └─→ scripts/marketing_utils.py |
| 77 | + ├─ For: Automated campaign tracking setup |
| 78 | + ├─ Use when: Need to generate UTM parameters |
| 79 | + └─ Contains: Generate, validate, batch URL processing |
| 80 | +``` |
| 81 | + |
| 82 | +--- |
| 83 | + |
| 84 | +## Size & Token Reference |
| 85 | + |
| 86 | +**File sizes** (for understanding context efficiency): |
| 87 | + |
| 88 | +| File | Lines | Type | Purpose | |
| 89 | +|------|-------|------|---------| |
| 90 | +| SKILL.md | ~300 | Core | Entry point, workflows, principles | |
| 91 | +| campaigns.md | ~450 | Reference | Campaign frameworks & templates | |
| 92 | +| content.md | ~400 | Reference | Copywriting & content guidelines | |
| 93 | +| social_media.md | ~350 | Reference | Platform-specific strategies | |
| 94 | +| email.md | ~450 | Reference | Email templates & best practices | |
| 95 | +| analytics.md | ~400 | Reference | Analytics & KPI frameworks | |
| 96 | +| brand.md | ~350 | Reference | Brand & voice guidelines | |
| 97 | +| templates.md | ~500+ | Reference | Ready-to-use templates | |
| 98 | +| marketing_utils.py | ~300 | Script | Utility functions | |
| 99 | + |
| 100 | +**Total: ~3,500+ lines** - Comprehensive yet efficient |
| 101 | + |
| 102 | +Each reference file is under 500 lines, allowing Claude to load complete files when needed without excessive context penalty. Files are independent and can be read without loading others. |
| 103 | + |
| 104 | +--- |
| 105 | + |
| 106 | +## Quick Reference By Use Case |
| 107 | + |
| 108 | +### "I need to plan a new campaign" |
| 109 | +1. Read: [SKILL.md](SKILL.md) → Section "Workflow: Campaign Development & Execution" |
| 110 | +2. Use: [reference/campaigns.md](reference/campaigns.md) → "Campaign Development Template" |
| 111 | +3. Reference: [reference/analytics.md](reference/analytics.md) → "Success Metrics & Targets" |
| 112 | + |
| 113 | +### "I need to write marketing copy" |
| 114 | +1. Read: [reference/content.md](reference/content.md) → "Copywriting Fundamentals" |
| 115 | +2. Choose: [reference/templates.md](reference/templates.md) → Select template |
| 116 | +3. Customize: Fill template with your specific messaging |
| 117 | + |
| 118 | +### "I need to plan social media content" |
| 119 | +1. Read: [reference/social_media.md](reference/social_media.md) → Platform section |
| 120 | +2. Use: [reference/social_media.md](reference/social_media.md) → "Social Media Campaign Framework" |
| 121 | +3. Reference: [reference/templates.md](reference/templates.md) → "Social Media Content Calendar Template" |
| 122 | + |
| 123 | +### "I need to send an email campaign" |
| 124 | +1. Choose: [reference/email.md](reference/email.md) → Email type (welcome, nurture, promotional) |
| 125 | +2. Use: [reference/templates.md](reference/templates.md) → Email template |
| 126 | +3. Reference: [reference/email.md](reference/email.md) → Best practices & metrics |
| 127 | + |
| 128 | +### "I need to measure campaign performance" |
| 129 | +1. Read: [reference/analytics.md](reference/analytics.md) → "Marketing Funnel Framework" |
| 130 | +2. Define: [reference/analytics.md](reference/analytics.md) → "Essential Marketing KPIs" |
| 131 | +3. Implement: [scripts/marketing_utils.py](scripts/marketing_utils.py) → Generate tracking URLs |
| 132 | + |
| 133 | +### "I need to ensure brand consistency" |
| 134 | +1. Read: [reference/brand.md](reference/brand.md) → "Brand Voice & Tone" |
| 135 | +2. Reference: [reference/brand.md](reference/brand.md) → "Visual Branding" & "Campaign Creative Guidelines" |
| 136 | +3. Use: Throughout all campaigns |
| 137 | + |
| 138 | +### "I need to set up campaign tracking" |
| 139 | +1. Run: `python scripts/marketing_utils.py --help` |
| 140 | +2. Use: [scripts/marketing_utils.py](scripts/marketing_utils.py) examples |
| 141 | +3. Batch generate: From [examples/campaigns_sample.csv](examples/campaigns_sample.csv) |
| 142 | + |
| 143 | +--- |
| 144 | + |
| 145 | +## Navigation Tips |
| 146 | + |
| 147 | +### For Beginners |
| 148 | +**Start with**: README.md → SKILL.md → One reference file based on your current need |
| 149 | + |
| 150 | +**Suggested First Tasks**: |
| 151 | +1. Read SKILL.md core principles |
| 152 | +2. Work through campaign planning template |
| 153 | +3. Choose a content type and use ready-made template |
| 154 | +4. Define success metrics |
| 155 | + |
| 156 | +### For Experienced Marketers |
| 157 | +**Start with**: Specific reference file based on current task |
| 158 | + |
| 159 | +**Advanced Features**: |
| 160 | +1. Use custom attribution models (analytics.md) |
| 161 | +2. Implement A/B testing frameworks (email.md, content.md) |
| 162 | +3. Scale campaigns using batch tools (scripts/marketing_utils.py) |
| 163 | +4. Create custom audience segments (campaigns.md) |
| 164 | + |
| 165 | +### For Skill Customization |
| 166 | +**Start with**: IMPLEMENTATION_GUIDE.md → Reference files for customization |
| 167 | + |
| 168 | +**Customization Priority**: |
| 169 | +1. Brand guidelines (brand.md) |
| 170 | +2. Terminology (all files) |
| 171 | +3. Audience types (campaigns.md) |
| 172 | +4. Company-specific examples (templates.md) |
| 173 | +5. Analytics tools & targets (analytics.md) |
| 174 | + |
| 175 | +--- |
| 176 | + |
| 177 | +## File Dependencies & Links |
| 178 | + |
| 179 | +**No file depends on other files being loaded** - This is by design. |
| 180 | + |
| 181 | +- Each reference file is self-contained |
| 182 | +- No circular references between files |
| 183 | +- All links point FROM reference files, not between them |
| 184 | +- SKILL.md is the only entry point |
| 185 | + |
| 186 | +This architecture ensures: |
| 187 | +- ✓ Efficient context usage |
| 188 | +- ✓ Parallel loading of information |
| 189 | +- ✓ No broken reference chains |
| 190 | +- ✓ Easy file updates without cascading changes |
| 191 | + |
| 192 | +--- |
| 193 | + |
| 194 | +## Updating & Maintenance |
| 195 | + |
| 196 | +### When to Add New Content |
| 197 | +- New template proves effective → Add to templates.md |
| 198 | +- Company process changes → Update SKILL.md workflow |
| 199 | +- New platform used → Add to social_media.md |
| 200 | +- New audience identified → Add to campaigns.md |
| 201 | + |
| 202 | +### When to Remove Content |
| 203 | +- Framework becomes outdated → Remove from relevant file |
| 204 | +- Tool is no longer used → Remove from analytics.md |
| 205 | +- Template never used → Remove from templates.md |
| 206 | + |
| 207 | +### When to Reorganize |
| 208 | +- File approaches 500 lines → Split into new file or move content |
| 209 | +- Reference section becomes self-contained → Create new file |
| 210 | +- Multiple sections address same topic → Consolidate |
| 211 | + |
| 212 | +--- |
| 213 | + |
| 214 | +## Backward Compatibility |
| 215 | + |
| 216 | +**Current Version**: 1.0 (October 2025) |
| 217 | + |
| 218 | +This skill is designed to work with: |
| 219 | +- Claude Opus 4.1 |
| 220 | +- Claude Sonnet 4.5 |
| 221 | +- Claude Haiku 4.5 |
| 222 | + |
| 223 | +**Future Versions**: Structure designed to accommodate additions without breaking existing references. |
| 224 | + |
| 225 | +--- |
| 226 | + |
| 227 | +## Quick Copy-Paste Sections |
| 228 | + |
| 229 | +### File Paths (Forward Slashes - Always) |
| 230 | +``` |
| 231 | +✓ reference/campaigns.md |
| 232 | +✓ scripts/marketing_utils.py |
| 233 | +✓ examples/campaigns_sample.csv |
| 234 | +
|
| 235 | +✗ reference\campaigns.md (Wrong - backslash) |
| 236 | +✗ docs/reference/campaigns (Wrong - missing .md) |
| 237 | +``` |
| 238 | + |
| 239 | +### Link Format (Markdown) |
| 240 | +``` |
| 241 | +[Text to display](reference/filename.md) |
| 242 | +[View campaign template](reference/campaigns.md#campaign-development-template) |
| 243 | +``` |
| 244 | + |
| 245 | +### Running Script |
| 246 | +```bash |
| 247 | +python scripts/marketing_utils.py generate_utm \ |
| 248 | + --source "email" \ |
| 249 | + --medium "newsletter" \ |
| 250 | + --campaign "Q3_launch" |
| 251 | +``` |
| 252 | + |
| 253 | +--- |
| 254 | + |
| 255 | +## Accessibility Notes |
| 256 | + |
| 257 | +All files are: |
| 258 | +- **Plain text markdown** (.md) - Accessible to all tools and systems |
| 259 | +- **Readable formatting** - Clear structure with headers and sections |
| 260 | +- **No special characters** - Uses only ASCII characters and markdown formatting |
| 261 | +- **Searchable** - All text is full-text searchable |
| 262 | +- **Linkable** - Each section can be linked to by URL/reference |
| 263 | + |
| 264 | +--- |
| 265 | + |
| 266 | +## Storage & Sharing |
| 267 | + |
| 268 | +The complete skill folder can be: |
| 269 | +- **Shared** - Copy entire folder to team members |
| 270 | +- **Backed up** - Store in version control (git) |
| 271 | +- **Deployed** - Upload to Claude skill system |
| 272 | +- **Customized** - Modify files for your company |
| 273 | +- **Extended** - Add new files while maintaining structure |
| 274 | + |
| 275 | +**Recommended**: Store in git repository for version tracking and collaboration. |
| 276 | + |
| 277 | +--- |
| 278 | + |
| 279 | +**Last Updated**: October 2025 |
| 280 | +**Version**: 1.0 |
| 281 | +**Compatible Models**: Claude 4 family (Opus 4.1, Sonnet 4.5, Haiku 4.5) |
0 commit comments