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>
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>
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>
web_fetch strips <script> tags during HTML→markdown conversion, which
silently discards JSON-LD schema blocks. Additionally, many CMS plugins
(AIOSEO, Yoast, RankMath) inject schema via client-side JavaScript,
making it invisible to both web_fetch and curl.
This has led to false audit findings in production (reporting 'zero
structured data' on sites with extensive schema implementation).
Adds a prominent warning in the Audit Framework section and a note
in the Tools section recommending browser rendering, Rich Results Test,
or Screaming Frog for accurate schema detection.
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
- 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>
Cherry-picked the genuinely unique content from PR #10 and integrated
into existing skills:
seo-audit/references:
- ai-writing-detection.md: AI writing patterns to avoid (em dashes,
overused phrases, filler words)
- aeo-geo-patterns.md: Answer Engine & Generative Engine Optimization
content patterns
copy-editing/references:
- plain-english-alternatives.md: Complex to simple word replacements
copywriting/references:
- natural-transitions.md: Transitional phrases for better content flow
Updated SKILL.md files to link to new references.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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>
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>
