marketing-demand-acquisition

I had to dig into how you're handling the demand-side metrics here—the scoring logic around acquisition efficiency is solid, but I'm curious about the edge cases when conversion funnels break down mid-cycle.

Links:

• GitHub
• Your agentic skill in the SkillzWave marketplace

The TL;DR

You're at 77/100, solid C territory. This is graded against Anthropic's best practices for agentic skills. Your Spec Compliance is chef's kiss (14/15)—the metadata and structure follow conventions well. But Progressive Disclosure Architecture is dragging you down (15/30). You've crammed a 986-line skill where 300 would do, and you're referencing files that don't exist. Fix that and you're looking at mid-80s.

What's Working Well

• Trigger terms are thorough – "demand gen," "paid ads," "CAC," "attribution" give Claude plenty of hooks to activate this skill at the right moments
• Real templates that work – The campaign brief, UTM structure, and Email templates aren't just descriptions; they're actually usable. And that calculate_cac.py script is practical
• Comprehensive for Series A+ startups – You're hitting demand generation, paid media, SEO, partnerships, and attribution. That's good coverage of the actual problem space
• Good pre-commit discipline – The checklists (Technical SEO, Campaign Planning) show you thought about validation steps

The Big One: Missing Reference Architecture

Your skill references 4 files that don't exist: hubspot-workflows.md, campaign-templates.md, international-playbooks.md, attribution-guide.md. You're currently just listing them in the Resources section (lines 965-972) like they'll magically appear.

Why it matters: Progressive Disclosure Architecture means layering complexity. New users need a quick path to value; advanced users dig into references. You're breaking that contract—either commit to those files or cut them. Right now you're losing 7 points on this alone.

The fix: Either create those reference files in a references/ subdirectory (move the detailed HubSpot setup, ad copy frameworks, SEO checklists there), or strip them from your SKILL.md and acknowledge this is a single-file skill. If single-file, move templates to an Appendix section instead of treating them like they're documented elsewhere.

Other Things Worth Fixing

1. Token bloat in the main file – 986 lines is too much for a single SKILL.md. Detailed HubSpot setup (lines 107-135), ad copy frameworks (lines 243-257), and partnership templates (lines 544-571) should move to references. Target <300 lines for the main file. This alone gains +5 points.

2. Voice consistency – You're mixing imperative ("Use", "Create") with second-person ("you'll need", "your customers", "I'm thinking"). Pick one. Convert everything to imperative/infinitive: "Configure HubSpot" not "You'll need to configure". Fixes the Writing Style score (+2 points).

3. Strip the marketing language – "Expert acquisition playbook" and "2025 Best Practice" feel like marketing copy. Use neutral framing: "Acquisition playbook for Series A+ startups", "Current industry framework (2025)". Sounds more instructional. (+1 point)

4. Add validation loops – Many procedures tell Claude what to do but not how to verify it worked. After LinkedIn campaign setup or SEO checklist completion, add a "Validation" step: "Check Campaign Manager shows Active status" or "Run a Core Web Vitals audit". Closes feedback loops (+3 points).

Quick Wins

• Create or commit to references – This is your biggest lever. Either build those 4 markdown files or remove the references section (+7 points)
• Trim SKILL.md to <300 lines – Extract templates and detailed procedures to references (+5 points)
• Standardize voice to imperative – Quick pass through, swap "you/your" for direct commands (+2 points)
• Tighten language – Remove superlatives, add validation steps (+3-4 points)

You're close—fix the architecture and voice and you're easily in the 87-90 range.

Checkout your skill here: SkillzWave.ai | SpillWave We have an agentic skill installer that install skills in 14+ coding agent platforms. Check out this guide on how to improve your agentic skills.