Commit graph

8 commits

Author SHA1 Message Date
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
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
Claude
1865cd29be
fix: move version from top-level to metadata in all SKILL.md frontmatter
Per the Agent Skills spec, `version` is not a valid top-level frontmatter
field. It belongs under `metadata` as a key-value pair. This fixes all 25
skills to use the correct structure.

https://claude.ai/code/session_01DboBqyncsUPg5Z5qpLJx4x
2026-02-15 09:43:44 +00:00
Corey Haines
1999e8f8b3 feat: add skill version tracking system
- Add version: 1.0.0 to all 25 skill YAML frontmatters
- Create VERSIONS.md manifest listing all skill versions
- Add update check instructions to AGENTS.md

This enables users to be notified of skill updates and easily
pull the latest changes when 2+ skills are updated or there is
a major version bump.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 11:30:07 -08:00
Corey Haines
98e74b79d7 Refactor remaining skills for progressive disclosure
Phase 2 refactoring of skills >500 lines and medium-sized skills:

- paid-ads: 553 → 297 lines
  - Extract ad-copy-templates.md, audience-targeting.md, platform-setup-checklists.md

- analytics-tracking: 541 → 292 lines
  - Extract ga4-implementation.md, gtm-implementation.md, event-library.md

- ab-test-setup: 510 → 264 lines
  - Extract test-templates.md, sample-size-guide.md

- copywriting: 458 → 248 lines
  - Extract copy-frameworks.md (headline formulas, section types)

- page-cro: 336 → 180 lines
  - Extract experiments.md (experiment ideas by page type)

- onboarding-cro: 435 → 218 lines
  - Extract experiments.md (onboarding experiment ideas)

All skills now use progressive disclosure with references/ folders,
keeping SKILL.md files focused on core workflow while detailed
content is available when needed.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 16:59:23 -08:00
Corey Haines
ce02e31251 Rename Questions to Ask -> Task-Specific Questions, remove redundant questions
Since product-marketing-context now captures foundational info (product, audience,
competitors, voice), removed redundant questions from these sections and renamed
them to clarify they are for task-specific context only.

Removed redundant questions from:
- competitor-alternatives (competitors, differentiator)
- copy-editing (audience, brand voice)
- email-sequence (audience)
- free-tool-strategy (product, audience problems)
- marketing-ideas (product, target customer)

Renamed section in all 23 skills with this pattern.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 16:12:12 -08:00
Corey Haines
f58dba09c8 Add product-marketing-context skill and update all skills to reference it
Users repeat the same foundational questions (product, audience, competitors,
voice) across 24 skills. This adds a centralized context document that other
skills can reference.

New skill:
- product-marketing-context: Creates .claude/product-marketing-context.md
- Covers 12 sections based on positioning canvas framework
- Can auto-draft V1 from codebase or gather info conversationally

Updated all 24 existing skills to check for product marketing context first,
reducing repetitive questions when context already exists.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 16:00:38 -08:00
Corey Haines
3617bdc883 Restructure skills for add-skill compatibility
Each skill now in its own directory with SKILL.md file
Required for npx add-skill integration
2026-01-16 10:57:00 -08:00
Renamed from skills/ab-test-setup.md (Browse further)