Site Audit strategy library: pillar + 4 strategies - #322
Merged
Conversation
Third topic in the strategy library, built to the same shape as Keyword Research (every-app#128, every-app#187) and Competitive Analysis (every-app#237): a pillar at /library/site-audit with four strategies under it, plus a guides section on the Site Audit feature page pointing into it. | | Strategy | Grounded in | |---|---|---| | 01 | The technical SEO audit checklist that ends in fixes, not findings | run_site_audit, get_audit_issues | | 02 | Write an SEO audit report the client will actually act on | get_audit_issues (how_to_fix) | | 03 | Index bloat: when the fix is deleting pages | get_audit_pages, inspect_urls | | 04 | When your own crawler gets blocked | get_audit_pages (fetchClass) | Every figure came out of real OpenSEO runs against unscriptedseo.com and seoarcade.com rather than illustrative examples. Screenshots are real app screenshots from those audits. Multi-guest and topic-led throughout: two practitioners per strategy, drawn from Patrick Stox, Grant Simmons and Chris Green, every quote verbatim from an interview transcript, each guest's episode linked once in their own section. Also sweeps one pre-existing "## Final thought" heading in content/blogs/seo-for-startups.md to the standard added to the deslop skill today, per principle 6 of openseo-review-web-content. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The four site audit strategy pages each render a five-question FAQ section but emitted no FAQPage JSON-LD, so none of those 20 questions were machine-readable. Each spoke now emits FAQPage markup built from the same questions and answers the page renders, copied verbatim from the MDX so the schema matches the visible content. BreadcrumbList was already covered by LibrarySpokePage, so no change there. Also rewrote the four verdict bullets in index-bloat.mdx. All four opened with a bolded keyword, which reads as generated text; the Search Console verdicts now sit inside the sentences that explain what to do about them. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R5c56XeUKSKJSaVjPU2Jpc
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R5c56XeUKSKJSaVjPU2Jpc
jeremypenguin-max
changed the title
ywwenjin163
pushed a commit
to ywwenjin163/open-seo
that referenced
this pull request
Sep 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Third topic in the strategy library, same shape as Keyword Research (#128, #187) and Competitive Analysis (#237): a pillar at
/library/site-auditwith four strategies under it, plus aguidessection on the Site Audit feature page pointing into it.Rebased onto current
maintoday. TheLibrarySpokePagecomponent and the library index changes from #479 are already upstream, so this only adds the site-audit entries.What's here
get_audit_issuesget_audit_pagesget_audit_pages,inspect_urlsget_audit_issuesEach strategy ends with a copy-paste MCP prompt and links
/docs/mcp, the relevant skills, and the feature page. FAQPage JSON-LD on each spoke, same pattern as #240.Every number came out of OpenSEO
Screenshots are real app screenshots from those runs, cropped to the data with account and domain chrome removed, kebab-case filenames, real alt text.
Quotes
Topic-led and multi-guest: Grant Simmons (Homes.com / Fiat Growth), Patrick Stox (built Site Audit at Ahrefs), Chris Green (Torque Partnership). Every quote is verbatim from an interview transcript. No page is about any one guest or their company.
Checks
types:checkclean,build:appclean, prettier clean on every changed file.🤖 Generated with Claude Code
https://claude.ai/code/session_01R5c56XeUKSKJSaVjPU2Jpc