Commit graph

9 commits

Author SHA1 Message Date
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
a4e7890eb1
Merge pull request #52 from upalkhouski/claude/fix-skill-version-property-0LwK3
Fixes spec compliance — version belongs under metadata, not top-level. Fixes Claude Desktop skill loading.
2026-02-18 01:25:26 -05:00
willscott-v2
170af13f24 seo-audit: Add warning about web_fetch unable to detect JS-rendered schema
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.
2026-02-15 07:12:46 -06: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
91d2e6d5f9 Add valuable reference content from PR #10
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>
2026-01-26 17:19:33 -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/seo-audit.md (Browse further)