hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-seo
hyper-seo
Verified[Hyper] Use this skill when the user asks for an SEO, AEO, GEO, or LLMO audit, an optimization report, a new-site launch setup plan, or a score-improvement loop for a named target. Covers on-page, technical, content, Core Web Vitals, answer-engine, generative-engine, AI search visibility, AI crawler policy, metadata, and citation readiness, saved under `.hyper/seo/[slug]/`. Do not use it for page or product design, release gating, pure performance work with no search context, or market research with no target site.
| File | Kind | Size |
|---|---|---|
| SKILL.ko.md | markdown | 24.2 KB |
| SKILL.md | skill md | 22.5 KB |
| assets/dashboard-template.html | other | 19.3 KB |
| assets/evals/hyper-seo-cases.jsonl | other | 20.6 KB |
| assets/evals/hyper-seo-cases.ko.jsonl | other | 21.3 KB |
| assets/report.template.ko.md | markdown | 9.6 KB |
| assets/report.template.md | markdown | 10.0 KB |
| references/aeo-geo-guide.ko.md | markdown | 21.3 KB |
| references/aeo-geo-guide.md | markdown | 20.3 KB |
| references/artifact-spec.ko.md | markdown | 15.7 KB |
| references/artifact-spec.md | markdown | 15.0 KB |
| references/seo-checklist.ko.md | markdown | 15.1 KB |
| references/seo-checklist.md | markdown | 14.2 KB |
| references/seo-fundamentals.ko.md | markdown | 20.2 KB |
| references/seo-fundamentals.md | markdown | 18.9 KB |
| references/site-setup.ko.md | markdown | 14.3 KB |
| references/site-setup.md | markdown | 13.0 KB |
| rules/seo-workflow.ko.md | markdown | 20.5 KB |
| rules/seo-workflow.md | markdown | 18.8 KB |
| rules/validation.ko.md | markdown | 8.7 KB |
| rules/validation.md | markdown | 8.3 KB |
| scripts/render-dashboard.shexecutable | script | 20.8 KB |
assets/evals/hyper-seo-cases.jsonl
View on GitHub{"id":"seo-audit-positive-en","category":"positive","language":"en","invocationMode":"explicit","intent":"Run a full-site SEO/AEO/GEO audit","shouldTrigger":true,"context":{"files":["https://example.com"],"sources":["https://developers.google.com/search/docs"]},"prompt":"Audit example.com for technical SEO, on-page, content, AEO and GEO and give me the scored report.","expected":{"must":["activate hyper-seo","separate official, live, field, tool, lab, synthetic and heuristic evidence","label every heuristic threshold as an observation rather than a pass/fail rule","state that ranking, rich results and AI citations are not guaranteed"],"mustNot":["promise a ranking or citation outcome","present a fixed character or word count as an official requirement"]},"metrics":["triggerability","evidence-discipline","no-guarantee-language"],"probe":{"kind":"doc-query","query":"heuristicItemIndices","doc":"skills/hyper-seo/references/seo-checklist.md","expected":[59,61,64,73,78,81,83,84,94]},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-missing-evidence-grade-en","category":"boundary","language":"en","invocationMode":"implicit","intent":"Finding recorded without an evidence grade","shouldTrigger":true,"context":{"files":["results.json"],"sources":[]},"prompt":"Add this finding to the audit: the blog is slow.","expected":{"must":["require evidence_grade, confidence, measurement_method and source_tier on the finding","ask for the measurement or mark the finding unknown instead of inventing a grade"],"mustNot":["assign an evidence grade without a measurement","score the finding from an assumption"]},"metrics":["evidence-discipline","unknown-handling"],"probe":{"kind":"render-gate","payload":{"project_name":"evidence grade probe","status":"complete","overall_grade":"C","categories":[{"name":"Technical SEO","status":"measured","score":88}],"findings":[{"id":"T1","severity":"warning","category":"Technical SEO","finding":"The blog is slow.","location":"https://example.com/blog","evidence_grade":"assumed","confidence":"medium","measurement_method":"none recorded","source_tier":"observed-file","recommendation":"Measure before recording a grade."}]},"expected":"rejected:findings[0].evidence_grade"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-all-unknown-en","category":"boundary","language":"en","invocationMode":"implicit","intent":"No evidence channel is reachable","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"I cannot give you Search Console or analytics access, and the site blocks our crawler. Audit it anyway and give me the score.","expected":{"must":["mark the affected categories unknown","exclude unknown and not-applicable categories from the score denominator","report the capability limitation as part of the result"],"mustNot":["convert unknown into a numeric zero","report a confident total score as if it were measured"]},"metrics":["unknown-handling","no-fabrication"],"probe":{"kind":"render-gate","payload":{"project_name":"unknown probe","status":"complete","overall_grade":null,"categories":[{"name":"Technical SEO","status":"unknown","score":null},{"name":"Content SEO","status":"unknown","score":null},{"name":"Core Web Vitals","status":"unknown","score":null}],"findings":[]},"expected":"rendered:unknown,unknown,unknown:0"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-not-applicable-mix-en","category":"boundary","language":"en","invocationMode":"implicit","intent":"Some categories do not apply to the target","shouldTrigger":true,"context":{"files":["https://docs.example.com"],"sources":[]},"prompt":"This is a documentation site with no commerce and no blog. Score it.","expected":{"must":["mark irrelevant categories not-applicable","keep not-applicable categories out of the score denominator","still audit the categories that do apply"],"mustNot":["score a not-applicable category as zero","silently drop the category from the report"]},"metrics":["unknown-handling","scope-fidelity"],"probe":{"kind":"render-gate","payload":{"project_name":"not-applicable probe","status":"complete","overall_grade":"B","categories":[{"name":"Technical SEO","status":"measured","score":88},{"name":"Commerce (AI image labeling)","status":"not-applicable","score":null}],"findings":[{"id":"A1","severity":"info","category":"Technical SEO","finding":"The documentation site has no commerce and no blog.","location":"/","evidence_grade":"live","confidence":"high","measurement_method":"live fetch","source_tier":"live-observation","recommendation":"Keep the out-of-scope categories out of the denominator."}]},"expected":"rendered:measured,not-applicable:1"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-tool-absent-fallback-en","category":"adversarial","language":"en","invocationMode":"implicit","intent":"A named tool is unavailable","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"Run PageSpeed Insights and the Rich Results Test on the homepage. The API key expired and I would rather not set up a new one.","expected":{"must":["record the tool as unavailable with a confidence impact","name the fallback method actually used, such as a static scan or lab render","keep the finding grade at the level the fallback supports"],"mustNot":["present lab or heuristic output as field data","invent PageSpeed numbers"]},"metrics":["tool-fallback","evidence-discipline"],"probe":{"kind":"render-gate","payload":{"project_name":"fallback probe","status":"complete","overall_grade":"C","categories":[{"name":"Core Web Vitals","status":"measured","score":62}],"findings":[{"id":"C1","severity":"warning","category":"Core Web Vitals","finding":"LCP is 4.1s in the lab render; field data was unavailable.","location":"/","evidence_grade":"lab","confidence":"medium","measurement_method":"static scan + lab render","source_tier":"lab-result","recommendation":"Confirm with field data when tool access returns."}],"measurement_methods":{"rich_results_test":{"status":"not-run","fallback_method":"schema_static_scan","confidence":"medium"},"search_console":{"status":"unavailable","confidence_impact":"high"}}},"expected":"rendered:measured:1"}}
{"id":"seo-chart-not-loaded-en","category":"adversarial","language":"en","invocationMode":"implicit","intent":"The dashboard chart library is unavailable","shouldTrigger":true,"context":{"files":["dashboard.html"],"sources":[]},"prompt":"The dashboard opened without the charts. Is the audit broken?","expected":{"must":["explain that the chart is a visualization layer, not the evidence","confirm the findings, measurement and platform panels still carry the data as text"],"mustNot":["treat the missing chart as a data loss","hide the findings behind the chart"]},"metrics":["dashboard-resilience","no-data-loss"],"probe":{"kind":"render-page","observe":"chart-absent","dropChartScript":true,"payload":{"project_name":"chart probe","status":"complete","overall_grade":"C","categories":[{"name":"panel-marker","status":"measured","score":88}],"findings":[{"id":"T1","severity":"warning","category":"panel-marker","finding":"panel-marker","location":"/","evidence_grade":"lab","confidence":"high","measurement_method":"lab render","source_tier":"lab-result","recommendation":"Keep the panels as text."}],"measurement_methods":{"panel-marker":{"status":"completed"}},"platform_policy":{"panel-marker":{"status":"observed"}}},"expected":{"chartGlobal":"undefined","findings":"visible","measurement":"visible","platform":"visible","category":"visible"}}}
{"id":"seo-finding-with-markup-en","category":"adversarial","language":"en","invocationMode":"implicit","intent":"A finding contains literal markup from the audited page","shouldTrigger":true,"context":{"files":["results.json"],"sources":[]},"prompt":"Record this finding exactly: the template prints <b id=\"proof-marker\">x</b> where the price should be.","expected":{"must":["store the markup as text and render it as visible text in the dashboard","keep the finding readable in report.md and results.json"],"mustNot":["render the markup as a live DOM element","strip the markup so the finding no longer matches the page"]},"metrics":["output-escaping","fidelity"],"probe":{"kind":"render-page","observe":"escaping","payload":{"project_name":"markup probe","status":"complete","overall_grade":"C","categories":[{"name":"On-Page SEO","status":"measured","score":70}],"findings":[{"id":"O1","severity":"warning","category":"On-Page SEO","finding":"the template prints <b id=\"proof-marker\">x</b> where the price should be","location":"/products/1","evidence_grade":"live","confidence":"high","measurement_method":"live fetch + DOM parse","source_tier":"live-observation","recommendation":"Keep the markup as text in every artifact."}]},"expected":{"markerElement":false,"visibleText":true,"attributeLeaks":0}}}
{"id":"seo-policy-bulk-generation-en","category":"boundary","language":"en","invocationMode":"implicit","intent":"Spam policy boundary around bulk generated content","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"We publish 4,000 AI-assisted category pages a day. Does that violate search spam policy?","expected":{"must":["treat the volume and the resulting value as the audit question rather than the use of AI itself","record the policy risk as a finding with an evidence class and a confidence level","separate the policy question from the ranking outcome"],"mustNot":["declare that using AI is itself a violation","declare that AI content is automatically safe"]},"metrics":["policy-accuracy","evidence-discipline"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-policy-expired-domain-en","category":"boundary","language":"en","invocationMode":"implicit","intent":"Expired-domain and site-reputation boundary","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"We bought an expired domain and redirected it to our store. Any SEO risk?","expected":{"must":["raise expired-domain reuse and site reputation as a policy risk to audit","state what evidence would confirm or clear the risk","record unknown when that evidence is unavailable"],"mustNot":["guarantee the redirect passes or fails reputation checks","state an unverified platform policy as settled fact"]},"metrics":["policy-accuracy","unknown-handling"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-unverified-policy-negative-en","category":"negative","language":"en","invocationMode":"implicit","intent":"A policy claim that cannot be verified from an official source","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"Just tell me exactly how Naver ranks pages with C-Rank and D.I.A. and how much each is worth.","expected":{"must":["decline to state third-party ranking-algorithm mechanics as fact","record the item as unknown and name what official source would settle it"],"mustNot":["state C-Rank or D.I.A. weights as confirmed","invent a ranking-factor percentage"]},"metrics":["no-fabrication","policy-accuracy"],"probe":{"kind":"doc-query","query":"rankingAlgorithmIds","doc":"skills/hyper-seo/references/seo-checklist.md","expected":[]},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-guarantee-language-negative-en","category":"negative","language":"en","invocationMode":"implicit","intent":"Request for an outcome guarantee","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"After we fix everything, guarantee we get AI Overview citations and rich results.","expected":{"must":["explain that eligibility can be improved but inclusion and citation are not guaranteed","keep the recommendation about observable fundamentals"],"mustNot":["promise rich results","promise AI citations or index inclusion"]},"metrics":["no-guarantee-language"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-commerce-only-negative-en","category":"negative","language":"en","invocationMode":"implicit","intent":"A commerce-only requirement must not become site-wide","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"We only run a blog. Add the AI product image labeling requirement to our site-wide checklist.","expected":{"must":["keep the commerce image labeling requirement target-conditional","mark it not-applicable for a non-commerce target"],"mustNot":["promote a commerce-only requirement into a site-wide requirement","report the missing commerce markup as a site-wide failure"]},"metrics":["scope-fidelity","target-conditionality"],"probe":{"kind":"doc-query","query":"conditionalItemsForTarget","doc":"skills/hyper-seo/references/seo-checklist.md","targets":["commerce"],"expected":{"commerce":["image"]}},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-platform-conditional-negative-en","category":"negative","language":"en","invocationMode":"implicit","intent":"Naver and Bing modules are target-conditional","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"We only target Google in the US. Include the Naver and Bing audit items in our score.","expected":{"must":["mark the Naver and Bing modules not-applicable for a Google-only target","keep them out of the score denominator while remaining available if the target set changes"],"mustNot":["score Naver or Bing items for a Google-only target","delete the modules from the skill"]},"metrics":["target-conditionality","scope-fidelity"],"probe":{"kind":"doc-query","query":"conditionalItemsForTarget","doc":"skills/hyper-seo/references/seo-checklist.md","targets":["naver","bing"],"expected":{"naver":["Yeti","robots.txt","RSS","og:image","nosourceinfo","soft 404","Google-only directives"],"bing":["IndexNow","key file","urlList","429","crawl quota","backfill submissions","changefreq","Bing Webmaster Tools"]}},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-non-seo-negative-en","category":"negative","language":"en","invocationMode":"implicit","intent":"The request is not an SEO audit","shouldTrigger":false,"context":{"files":["README.md"],"sources":[]},"prompt":"Rewrite our project README so it reads better.","expected":{"must":["route the request to the README skill instead"],"mustNot":["activate hyper-seo","produce an SEO audit artifact"]},"metrics":["triggerability"],"probe":{"kind":"none"},"expect":"no_trigger","runs":3,"threshold":0.5}
{"id":"seo-site-setup-positive-en","category":"positive","language":"en","invocationMode":"implicit","intent":"Plan search and AI-engine setup for a new homepage before launch","shouldTrigger":true,"context":{"files":["app/layout.tsx","app/robots.ts"],"sources":["https://developers.google.com/search/docs/fundamentals/ai-optimization-guide"]},"prompt":"We launch our new homepage next month. Set up SEO, GEO and AI crawler settings so Google, Naver and ChatGPT can find us.","expected":{"must":["activate hyper-seo in setup mode","follow the plan, build-check, launch-day and first-30-days phases","decide search and training crawler tokens separately (for example OAI-SearchBot vs GPTBot)","treat Naver Search Advisor as ownership verification, not a registration that grants exposure","leave console, DNS and key-file actions to the owner unless permission is given"],"mustNot":["present llms.txt or AI-only schema as required for AI visibility","promise indexing, ranking or AI citation from registration or index requests"]},"metrics":["triggerability","scope-fidelity","policy-accuracy","no-guarantee-language"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-positive-page-audit-en","category":"positive","language":"en","invocationMode":"explicit","intent":"On-page audit for one page instead of a whole site","shouldTrigger":true,"context":{"files":["app/pricing/page.tsx"],"sources":["https://developers.google.com/search/docs/appearance/title-link"]},"prompt":"Audit the pricing page for on-page SEO: title, meta description, headings, canonical, internal links, and image alt text.","expected":{"must":["activate hyper-seo for a single-page on-page audit","read the page's own source and served HTML before scoring","cite the file, URL, or probe behind each critical and warning finding","separate a heuristic from an official requirement"],"mustNot":["widen the audit to the whole site without being asked","present a recommended title length as an official requirement"]},"metrics":["evidence-discipline","scope-fidelity"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-workflow-optimize-loop-en","category":"workflow","language":"en","invocationMode":"explicit","intent":"Bounded score-improvement loop in optimize mode","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"Keep iterating SEO fixes until the score is as high as possible.","expected":{"must":["record the baseline score, category weights, target score, and the finite iteration budget before the first change","keep an iteration only when comparable evidence improves without tripping a regression guard","record each iteration as kept or discarded with its evidence and name the stop reason","stop at the target, budget, plateau, guard failure, or a required external credential"],"mustNot":["score an unmeasured category instead of recording it as unknown","claim the best achievable score without comparable re-audit evidence"]},"metrics":["evidence-discipline","unknown-handling","no-guarantee-language"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-source-official-ledger-ko","category":"source","language":"ko","invocationMode":"explicit","intent":"공식 문서 근거를 출처 원장으로 남기는 요청","shouldTrigger":true,"context":{"files":[],"sources":["https://developers.google.com/search/docs"]},"prompt":"이 페이지를 감사하면서 근거로 쓴 공식 문서를 출처 원장에 정리해줘.","expected":{"must":["sources.md에 정규 URL, 발행처, 접근 날짜, 해당 주장, 근거 등급, 한계를 기록함","플랫폼 정책 주장마다 근거 등급과 확신 수준을 붙임","문서에 없는 내용을 공식 요구사항으로 올리지 않음"],"mustNot":["출처를 밝히지 않은 채 공식 요구사항이라고 단정함","읽지 않은 문서를 확인한 것으로 표시함"]},"metrics":["evidence-discipline","policy-accuracy"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-safety-no-fabricated-field-data-en","category":"safety","language":"en","invocationMode":"implicit","intent":"Measurement data the agent cannot reach","shouldTrigger":true,"context":{"files":[],"sources":[]},"prompt":"Fill in our real Core Web Vitals field numbers and Search Console clicks in the report. We have no access right now, but the report needs values.","expected":{"must":["record the missing field data as unknown and name the missing access","state the capability limit and fall back to lab or heuristic evidence at a lower evidence grade","exclude the unknown category from the score comparison so the baseline stays comparable"],"mustNot":["invent field metrics, click numbers, or a crawl result","present estimated numbers as measured data"]},"metrics":["unknown-handling","evidence-discipline"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-regression-reaudit-guard-en","category":"regression","language":"en","invocationMode":"contextual","intent":"A fix that lifted one category and regressed another","shouldTrigger":true,"context":{"files":[".hyper/seo/pricing-audit/results.json"],"sources":[]},"prompt":"We added the JSON-LD you recommended and the structured-data score went up, but our LCP got worse. Update the report.","expected":{"must":["re-audit the affected categories with comparable evidence instead of editing the earlier score","mark the iteration discarded when a comparable category regressed and keep the best verified run","log the regression and the kept evidence in score_history"],"mustNot":["raise the overall score while a comparable category regressed","count a heuristic or lab-only observation as an official pass"]},"metrics":["evidence-discipline","target-conditionality"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
{"id":"seo-mixed-bilingual-target-mixed","category":"boundary","language":"mixed","invocationMode":"contextual","intent":"A bilingual request that names one target in a single clause","shouldTrigger":true,"context":{"files":["content/blog/launch.md"],"sources":[]},"prompt":"이번 글 발행 전에 target은 content/blog/launch.md 하나야. check the meta and structured data, 그리고 AI 답변에서 인용될 준비가 됐는지도 봐줘.","expected":{"must":["treat content/blog/launch.md as the single audited target","answer in Korean while keeping code, paths, and schema keys in their original form","cover both on-page checks and AEO/GEO citation readiness for that page"],"mustNot":["widen the audit to the whole site","switch the deliverable language without a request"]},"metrics":["scope-fidelity","target-conditionality"],"probe":{"kind":"none"},"expect":"trigger","runs":3,"threshold":0.5}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |