Commit graph

157 commits

Author SHA1 Message Date
bengizmo
1e70d8387b feat: fork marketingskills → HVAC Marketing Skills for Compendium
Some checks failed
Sync Skills / sync (push) Has been cancelled
Validate Agent Skill / detect-changes (push) Has been cancelled
Validate Agent Skill / validate (push) Has been cancelled
- Forked from coreyhaines31/marketingskills v1.1.0 (MIT license)
- Removed 4 SaaS-only skills (churn-prevention, paywall-upgrade-cro, onboarding-cro, signup-flow-cro)
- Reworked 2 skills (popup-cro → hvac-estimate-popups, revops → hvac-lead-ops)
- Adapted all 28 retained skills with HVAC industry context and Compendium integration
- Created 10 new HVAC-specific skills:
  - hvac-content-from-data (flagship DB integration)
  - hvac-seasonal-campaign (demand cycle marketing)
  - hvac-review-management (GBP review strategy)
  - hvac-video-repurpose (long-form → social)
  - hvac-technical-content (audience-calibrated writing)
  - hvac-brand-voice (trade authenticity guide)
  - hvac-contractor-website-audit (discovery & analysis)
  - hvac-contractor-website-package (marketing package assembly)
  - hvac-compliance-claims (EPA/rebate/safety claim checking)
  - hvac-content-qc (fact-check & citation gate)
- Renamed product-marketing-context → hvac-marketing-context (global)
- Created COMPENDIUM_INTEGRATION.md (shared integration contract)
- Added Compendium wrapper tools (search, scrape, classify)
- Added compendium capability tags to YAML frontmatter
- Updated README, AGENTS.md, CLAUDE.md, VERSIONS.md, marketplace.json
- All 38 skills pass validate-skills.sh
- Zero dangling references to removed/renamed skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 21:05:49 -03:00
Corey Haines
2f5db8d95c
Merge pull request #76 from coreyhaines31/development
Release: skill descriptions, evals, and writing audit for all 32 skills
2026-03-04 16:44:37 -08:00
Corey Haines
3a8d01283d Merge branch 'main' into development 2026-03-04 16:07:41 -08:00
Corey Haines
68f5eaf64e
Merge pull request #75 from coreyhaines31/feature/skill-writing-audit
Audit skill bodies: replace rigid imperatives with reasoning
2026-03-04 15:59:35 -08:00
Corey Haines
51e29954fb
Merge pull request #74 from coreyhaines31/feature/skill-evals
Add evals for all 32 skills (197 total evals, 1261 assertions)
2026-03-04 15:59:31 -08:00
Corey Haines
a3ab09378b
Merge pull request #73 from coreyhaines31/feature/skill-description-optimization
Optimize all 32 skill descriptions for better triggering
2026-03-04 15:59:27 -08:00
Corey Haines
926c624d07 fix: address eval review - assertion mismatches and factual error
- marketing-psychology eval 4: BJ Fogg assertion did not match expected_output
  which lists Goal-Gradient Effect. Fixed.
- sales-enablement eval 2: all 6 categories assertion contradicted expected_output
  which only categorizes the 3 given objections. Fixed.
- ad-creative eval 5: TikTok hard limit corrected to recommended (80 chars
  recommended, 100 max) per SKILL.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 15:51:28 -08:00
Corey Haines
8c8090ed92 fix: resolve trigger phrase conflicts found in review
- sales-enablement: "ROI calculator" → "deal-specific ROI analysis" to avoid
  conflict with free-tool-strategy which also claims "ROI calculator"
- sales-enablement: clarified scope boundary to competitor-alternatives for
  battle cards (competitor-alternatives owns battle card creation)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 14:29:15 -08:00
Corey Haines
b325e41c91 fix: address review — two more rigid imperatives caught
- sales-enablement: "Never demo without discovery" → "Demo after discovery, not before"
- site-architecture: "No exceptions" → explains why (backlink equity, broken pages)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 14:28:30 -08:00
Corey Haines
b0a3a23699 refactor: replace rigid imperatives with reasoning-based guidance
Audit all 32 SKILL.md files against Anthropic's skill-creator writing
guidance ("why > MUST" pattern). Replaces ALWAYS/NEVER/MUST/IMPORTANT
imperatives with explanations of WHY the guidance matters.

17 edits across 14 skills:
- ad-creative: character limits reasoning, CTA headline reasoning
- seo-audit: schema detection warning softened, reasoning added
- programmatic-seo: subfolder vs subdomain reasoning
- paid-ads: exclusion list reasoning
- copywriting: honesty principle reasoning
- cold-email: follow-up value reasoning
- ai-seo: freshness signal reasoning
- churn-prevention: post-cancel path reasoning
- product-marketing-context: verbatim language reasoning
- popup-cro: close button visibility reasoning
- signup-flow-cro: label visibility reasoning
- form-cro: label visibility reasoning
- revops: fallback owner reasoning
- ab-test-setup: DON'T → Avoid

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 14:19:09 -08:00
Corey Haines
7e7e7a09d8 fix: align eval assertions with SKILL.md content per Codex review
Fixes 5 issues identified by independent Codex review:
- product-marketing-context: match auto-draft workflow, section flexibility
- marketing-psychology: replace phantom models with actual SKILL.md models
- ad-creative: correct RSA pinning guidance to match skill
- free-tool-strategy: boundary test now defers to related skill (page-cro)
- paywall-upgrade-cro: boundary test references only related skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 14:07:38 -08:00
Corey Haines
11e9ea811f feat: add evals for all 29 remaining skills (197 total evals across 32 skills)
Each skill now has 5-8 evals covering:
- Core framework usage with realistic prompts
- Casual trigger phrase variants
- Sub-type and section-specific coverage
- Boundary tests (skill deferral to related skills)
- Structured assertions for grading

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 13:37:01 -08:00
Corey Haines
831dbe9616 fix: improve evals with assertions, coverage gaps, and boundary tests
Changes per skill:

page-cro (5 -> 7 evals):
- Added structured assertions array to all evals
- Added Blog Post CRO eval (was missing)
- Added boundary eval: signup form should defer to signup-flow-cro
- Replaced feature page A/B test eval with fuller feature page eval

copywriting (5 -> 7 evals):
- Added structured assertions array to all evals
- Added About Page eval with voice/tone adaptation test
- Added boundary eval: email sequence should defer to email-sequence
- Added Quick Quality Check eval (buzzword/jargon/exclamation detection)
- Added meta content assertion to homepage eval

seo-audit (5 -> 8 evals):
- Added structured assertions array to all evals
- Added Local Business eval (NAP, GBP, location pages)
- Added Core Web Vitals / site speed eval
- Added boundary eval: FAQ schema should defer to schema-markup

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 13:12:20 -08:00
Corey Haines
6b1da2158e feat: add evals for page-cro, copywriting, and seo-audit skills
5 eval prompts per skill testing realistic user scenarios:
- page-cro: landing page audit, pricing page, homepage, feature page, redesign regression
- copywriting: homepage copy, headline rewrite, pricing page, landing page, CTA improvement
- seo-audit: full site audit, ranking diagnosis, migration recovery, e-commerce technical, blog content

Follows the skill-creator eval format with prompt + expected_output assertions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 13:07:12 -08:00
Corey Haines
e4283c6616 feat: optimize all 32 skill descriptions for better triggering
Following Anthropic skill-creator guidance that Claude undertriggers
skills, make descriptions pushier across all 32 skills:

- Add casual/frustrated user phrases
- Add implicit need triggers where users need the skill but dont name it
- Add catch-all sentences explaining when to use
- Add missing cross-references between related skills
- Ensure consistent format across all descriptions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 13:02:05 -08:00
Corey Haines
633f9c642d Merge branch 'development' 2026-03-04 12:57:50 -08:00
Corey Haines
89fd57a8b0
Merge pull request #70 from coreyhaines31/feature/new-connector-tools
Add 10 new CLI tools and integration guides
2026-03-04 12:51:35 -08:00
Corey Haines
a2e646c2e6 fix: update MCP tools list in CLAUDE.md, fix REGISTRY.md inconsistencies
- Add 6 new MCP-enabled tools to CLAUDE.md (zoominfo, clay, supermetrics,
  coupler, outreach, crossbeam)
- Fix broken Payments table in REGISTRY.md (blank row between stripe/paddle)
- Fix category name mismatch: "Competitive Intel" → "Competitive Intelligence"

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 12:42:15 -08:00
Corey Haines
9a2bb97784 fix: address codex review findings across new CLI tools
- supermetrics: fix query endpoint /query → /query/data/json
- airops: fix base URL /v1 → /public_api/v1
- zoominfo: fix auth --dry-run leaking real JWT, add response validation
- outreach: remove parseInt() on JSON:API string IDs (caused NaN)
- similarweb: add encodeURIComponent on domain in all URL paths
- coupler: fix dry-run auth mask from '***' to 'Bearer ***'
- clay: allow name-based enrich (--first-name + --last-name + --domain)
- pendo.md: fix guide state from 'published' to 'public'
- close.md: fix rate limit header names to ratelimit-*

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 23:08:36 -08:00
Corey Haines
4ff486a702 feat: add 10 new CLI tools and integration guides from Claude connectors
New tools: Clay, Outreach, ZoomInfo, Close, Pendo, Similarweb,
Supermetrics, AirOps, Crossbeam, and Coupler.io. Each includes a
zero-dependency Node.js CLI and an integration guide.

Updates REGISTRY.md with new tool index entries, categories, and
MCP-enabled tools list.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 21:59:51 -08:00
Corey Haines
a3516be13d Merge development into main for v1.3.0 release 2026-03-02 11:32:29 -08:00
Corey Haines
edd613d33f fix: correct typos and add missing skill in README relationship diagram
Fix "Measuremnt" typo, spell out truncated skill names (cold-email,
competitor, sales-enable), and add site-architecture to the diagram.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 11:31:41 -08:00
coreyhaines31
90a7e84d0e chore: sync skills with marketplace.json and README 2026-02-27 17:37:54 +00:00
Corey Haines
cac82f3a40
Merge pull request #69 from coreyhaines31/development
Release: v1.1.0 -- agent-agnostic migration, 7 new skills, 51 CLI tools
2026-02-27 12:37:43 -05:00
Corey Haines
3a13e58808 fix: correct skill count and branding in marketplace.json
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:35:35 -08:00
Corey Haines
e47e3a3073
Merge pull request #68 from coreyhaines31/feature/agents-directory-migration
Migrate context paths from .claude/ to .agents/
2026-02-27 12:28:04 -05:00
Corey Haines
8ea7487545 docs: rebrand to "Marketing Skills for AI Agents" with multi-agent support
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:19:51 -08:00
Corey Haines
1622c8e398 docs: add upgrading instructions for .agents/ migration
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:16:12 -08:00
Corey Haines
ee28bc4359 fix: add missing version metadata to cold-email skill
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:06:33 -08:00
Corey Haines
f5badfe416 feat: migrate context paths from .claude/ to .agents/ for agent-agnostic compatibility
The .agents/skills/ directory is the emerging cross-agent standard adopted by
OpenAI Codex, Cursor, Windsurf, and npx skills. All 32 skills now check
.agents/product-marketing-context.md first with .claude/ fallback for older
setups. Install paths in README updated accordingly. Bumps all skills to 1.1.0.

Closes #50

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 09:01:33 -08:00
Corey Haines
bc3253d30d
Merge pull request #63 from coreyhaines31/feature/revops-sales-enablement
Add revops and sales-enablement skills
2026-02-23 14:55:08 -05:00
Corey Haines
12c34eb714 fix: resolve merge conflicts with development after site-architecture merge
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 11:54:56 -08:00
Corey Haines
c4bc2fcc49
Merge pull request #62 from coreyhaines31/feature/sitemap-planner-skill
Add site-architecture skill
2026-02-23 14:54:22 -05:00
Corey Haines
0c24410a0b
Merge pull request #67 from coreyhaines31/development
Merge development into main
2026-02-23 14:52:55 -05:00
Corey Haines
066c420416
Merge pull request #66 from coreyhaines31/docs/readme-updates
Add Magister link, skill relationship diagram, and issues encouragement
2026-02-23 14:51:04 -05:00
Corey Haines
08c100bc7b docs: add Magister link, skill relationship diagram, and issues encouragement
Add Magister CTA to intro, skill dependency diagram showing how all 31
skills relate through product-marketing-context, and a link to open
issues for questions/problems.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 11:48:17 -08:00
Corey Haines
8618c5bad2 feat: add revops and sales-enablement skills
Fill the revenue operations and internal sales collateral gaps in the
marketing skills collection. revops covers lead lifecycle, scoring,
routing, pipeline management, and CRM automation. sales-enablement
covers pitch decks, one-pagers, objection handling, demo scripts, and
sales playbooks. Cross-references added to 6 existing skills.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 15:31:43 -08:00
Corey Haines
488d09cda5 feat: add site-architecture skill for website structure planning
Fills the gap between content strategy and SEO skills — covers page
hierarchy, navigation design, URL structure, and internal linking.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 03:29:50 -08:00
coreyhaines31
ea8df8290a chore: sync skills with marketplace.json and README 2026-02-19 20:56:56 +00:00
Corey Haines
4f803988e8
Merge pull request #58 from coreyhaines31/feature/churn-prevention-skill
Add churn-prevention skill
2026-02-19 15:56:46 -05:00
Corey Haines
4fef22901e fix: resolve merge conflicts with main after ai-seo merge
Both ai-seo and churn-prevention updated marketplace.json and
VERSIONS.md. Merged both entries, bumped skill count to 29.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 12:56:34 -08:00
coreyhaines31
16a2f788d4 chore: sync skills with marketplace.json and README 2026-02-19 20:56:00 +00:00
Corey Haines
8f8ae292ea
Merge pull request #59 from coreyhaines31/feature/ai-seo-skill
Add ai-seo skill for AI search optimization
2026-02-19 15:55:50 -05:00
Corey Haines
6914c62688 refactor: rewrite platform-ranking-factors to be original
Rewrote platform-ranking-factors.md from scratch with our own
organizational approach. Replaced table-heavy format with narrative
prose, different section structure, and synthesized analysis.
Updated SKILL.md robots.txt section to match.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 12:29:06 -08:00
Corey Haines
5436b34b98 feat: add GEO research data and platform-specific ranking factors
Add Princeton GEO study (KDD 2024) 9-method table with exact visibility
percentages to SKILL.md. Add AI bot robots.txt configuration. Add keyword
stuffing warning (-10% visibility). Add platform-ranking-factors.md reference
with per-platform details: Google AI Overviews (5-stage pipeline), ChatGPT
(content-answer fit 55%, 30-day freshness 3.2x), Perplexity (3-layer RAG,
FAQ Schema priority), Copilot (Bing index + MS ecosystem), Claude (Brave
Search, 38K:1 crawl-to-refer ratio).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 17:14:33 -08:00
Corey Haines
ce8dd3b41a feat: add ai-seo skill for AI search optimization (AEO, GEO, LLMO)
Split AEO/GEO content patterns out of seo-audit into a standalone ai-seo
skill. Covers AI visibility auditing, content extractability, authority
signals, third-party presence strategy, schema markup for AI, monitoring
tools (Otterly, Peec AI, ZipTie), and optimization by content type.

Moves aeo-geo-patterns.md from seo-audit/references to ai-seo/references
(renamed to content-patterns.md). Updates seo-audit to cross-reference
the new skill.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 17:06:09 -08:00
Corey Haines
10a708747d feat: add PostHog and ab-test-setup guidance for cancel flow experiments
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 14:04:04 -08:00
Corey Haines
abb6e87c04 feat: add churn-prevention skill for cancel flows, save offers, and dunning
Covers voluntary churn (exit surveys, dynamic save offers, pause/downgrade,
cancel flow UI patterns) and involuntary churn (smart retries, dunning emails,
card updaters, grace periods). Includes Churnkey-style offer-to-reason mapping,
health scoring model, proactive retention triggers, and provider-specific
dunning setup for Stripe, Chargebee, Paddle, and Recurly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 13:56:32 -08:00
Corey Haines
ce37279f12
Merge pull request #57 from coreyhaines31/feature/ad-creative-skill
Add ad-creative skill
2026-02-18 16:44:19 -05:00
Corey Haines
d4e6ef796c feat: add Voicebox as open-source ElevenLabs alternative
Free, local-first voice synthesis studio (MIT license) powered by Qwen3-TTS.
Voice cloning from short samples, local REST API, no per-character costs.
4-5x faster on Apple Silicon via MLX.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 10:23:33 -08:00