Add SEO/AEO skills for content optimization #17426
Conversation
New skills: - /seo-gap-analyzer: Research content coverage gaps and plan optimizations - /seo-enhance: Optimize content for search and AI discoverability Both use modular SKILL.md + references/ pattern with checklists for SEO fundamentals (title, meta, headings, internal links, alt text) and AEO patterns (quotable definitions, FAQ sections, listicles, tables). Also updates /new-blog-post to recommend /seo-enhance in next steps.
Documentation Review - PR #17426I've reviewed the SEO/AEO skills addition and found the content to be well-structured and comprehensive. The PR adds two new Claude Code skills with proper modular organization following the established SKILL.md + references/ pattern. ✅ StrengthsStructure and Organization:
Content Quality:
Style Compliance:
Integration:
📋 Minor ObservationsAll clear! No style, grammar, or structural issues found. The reference content includes example links showing both good and bad practices (e.g., "click here" vs descriptive anchors), which is intentional for educational purposes. ✨ SummaryThis PR adds valuable SEO/AEO capabilities to the documentation workflow with:
Both skills include comprehensive reference materials covering:
The content is well-written, properly structured, and ready for use. Recommendation: ✅ Approve If you need additional reviews or want me to check anything specific, mention @claude! |
|
Your site preview for commit ba06dc1 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-17426-ba06dc15.s3-website.us-west-2.amazonaws.com. |
- Clarify that 125 char limit for alt text is UX recommendation, not technical limit - Update seo-gap-analyzer to use Grep tool instead of bash grep examples Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
There was a problem hiding this comment.
Nice work on the SEO/AEO skills! These are well-researched and comprehensive.
Fixed before approval:
- Alt text guidance clarified (125 chars is UX recommendation, not technical limit)
- Updated to use Grep tool instead of bash grep examples
- Fixed trailing newlines and markdown spacing (Claude doesn't always follow proper Markdown rules)
Recommendation for follow-up:
Consider adding E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) as an 8th pattern in aeo-checklist.md. It's mentioned in seo-aeo-sources.md but not integrated into the evaluation checklist.
Verified:
- Pulumi positioning accurate (290+ providers confirmed)
- SEO/AEO guidelines align with Google's official documentation
- Workflows include proper approval gates
|
Your site preview for commit ab853fe is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-17426-ab853fe9.s3-website.us-west-2.amazonaws.com. |
|
Your site preview for commit 3b91518 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-17426-3b915189.s3-website.us-west-2.amazonaws.com. |
aeo-checklist.md: - Strengthen quotable definition guidance (no hedging/fluff) - Refine FAQ sections to target "doubt-removers" - Add Down-Funnel Specificity pattern (#9) - Add Agent-Friendly Content pattern (#10) - Update scoring to 10/10 and content type applicability table seo-gap-analyzer/SKILL.md: - Add Money Prompts framework for identifying high-value AEO targets - Add Reddit/Community Research guidance for user insights - Add Citation Gap Mapping to identify competitor citation advantages
asafashirov
force-pushed
the
asafashirov/seo-aeo-skills
branch
from
0739512 to
2c64881
Compare
|
Your site preview for commit 0739512 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-17426-07395128.s3-website.us-west-2.amazonaws.com. |
|
Your site preview for commit 2c64881 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-17426-2c648818.s3-website.us-west-2.amazonaws.com. |
|
@asafashirov Nice! I'll give this a test drive today and add a review. |
4 participants
Summary
Adds two new Claude Code skills for SEO and AEO (Answer Engine Optimization):
/seo-gap-analyzer- Research content coverage gaps for a topic and produce optimization plans/seo-enhance- Optimize individual pages for search and AI discoverabilityBoth skills use the modular
SKILL.md + references/pattern with comprehensive checklists.Changes
.claude/commands/seo-gap-analyzer/.claude/commands/seo-enhance//new-blog-postto recommend/seo-enhancein next stepsTest plan
/seo-gap-analyzer configuration managementand verify gap analysis output/seo-enhanceon an existing blog post and verify recommendations/new-blog-postand confirm/seo-enhanceappears in next steps