{"id":"3d303bdd-cae1-4440-a275-105181d2263d","shortId":"dvT8QR","kind":"skill","title":"seo-metadata-audit","tagline":"Perform a comprehensive SEO metadata audit on any webpage or HTML document, grounded in the 10 most important HTML meta tags. Use this skill whenever the user shares a URL, HTML source, or page content and asks about SEO, metadata, title tags, meta descriptions, canonical tags, s","description":"# SEO Metadata Audit\n\nPerform a structured audit of a webpage's HTML metadata against the 10 most important SEO meta tags. The framework is grounded in SearchEngineJournal and Google's official documentation.\n\nFor detailed per-tag audit checklists, scoring criteria, and common mistakes, read `references/tag-reference.md`.\n\n---\n\n## Audit Workflow\n\n### Step 1 — Collect the Data\n\nAsk for or extract the following from the provided URL, HTML source, or page description:\n\n- `` tag content and character count\n- `<meta name=\"description\">` content and character count\n- All `<h1>` through `<h6>` tags\n- Image `alt` attributes (sample if many)\n- External link `rel` attributes\n- `<meta name=\"robots\">` tag\n- `<link rel=\"canonical\">` tag\n- Any `<script type=\"application/ld+json\">` blocks\n- Open Graph (`og:*`) meta tags\n- Twitter card meta tags\n- `<meta name=\"viewport\">` tag\n\nIf the user provides a URL, fetch the page to extract this data. If they provide HTML, parse it directly.\n\n### Step 2 — Score Each Tag\n\nRead `references/tag-reference.md` for the full checklist per tag.\n\nRate each tag from 0 to its max score and calculate a total out of 46 possible points.\n\n| Score Range | Grade | Assessment |\n|---|---|---|\n| 40–46 | A | Excellent — production ready |\n| 30–39 | B | Good — minor fixes needed |\n| 20–29 | C | Fair — several important issues |\n| 10–19 | D | Poor — significant gaps |\n| 0–9 | F | Critical — metadata severely lacking |\n\n### Step 3 — Generate the Audit Report\n\nUse this exact structure:\n\n```\n# SEO Metadata Audit Report\n## Page: [URL or Page Name]\n## Date: [Date]\n\n### Executive Summary\n[2–3 sentence overview of key findings]\n\n### Score: XX / 46 — Grade: [A/B/C/D/F]\n\n### Tag-by-Tag Results\n\n| Tag | Score | Status | Key Finding |\n|---|---|---|---|\n| Title | X/5 | ✅/⚠️/❌ | ... |\n| Description | X/5 | ✅/⚠️/❌ | ... |\n| Headings | X/5 | ✅/⚠️/❌ | ... |\n| Image Alt | X/4 | ✅/⚠️/❌ | ... |\n| Nofollow | X/4 | ✅/⚠️/❌ | ... |\n| Robots | X/4 | ✅/⚠️/❌ | ... |\n| Canonical | X/5 | ✅/⚠️/❌ | ... |\n| Schema | X/5 | ✅/⚠️/❌ | ... |\n| Social (OG/Twitter) | X/5 | ✅/⚠️/❌ | ... |\n| Viewport | X/4 | ✅/⚠️/❌ | ... |\n\n### Priority Fixes (Ordered by Impact)\n1. [Highest impact issue]\n2. [Second priority]\n3. [Third priority]\n...\n\n### Detailed Findings & Recommendations\n[Per tag: what was found, what should be done, example code if needed]\n```\n\n### Step 4 — Provide Corrected Code\n\nFor any tag that fails or scores below 50% of its max, provide a corrected HTML snippet the user can copy directly into their page.\n\n---\n\n## Key Principles\n\n1. **Prioritize by ranking impact** — Fix `<title>` and `canonical` before social tags\n2. **Never keyword stuff** — Natural language always wins over mechanical repetition\n3. **Unique per page** — Title, description, canonical, and OG tags must all be page-specific\n4. **Test after changes** — Recommend Google Search Console, Rich Results Test, and Mobile-Friendly Test for validation\n5. **Mobile first** — If viewport is missing, flag it as high priority regardless of other scores\n\n---\n\n## Quick Cheat Sheet\n\n```html\n<!-- 1. Title -->\n<title>Primary Keyword - Secondary Topic | Brand Name\n\n\n\n\n\n
Primary Keyword Topic
\n
Subtopic One
\n
Sub-subtopic
\n\n\n\n\n\nLink Text\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n```\n\n---\n\n## Useful Tools\n\n| Tool | URL | Purpose |\n|---|---|---|\n| AITDK Extension | https://aitdk.com/zh-CN/extension/ | Free browser plugin: Title, Description, Headings, traffic |\n| Detailed SEO Extension | https://detailed.com/extension/ | Check Canonical, OG tags, Robots, Schema |\n| Google Rich Results Test | https://search.google.com/test/rich-results | Validate structured data |\n| Google Mobile-Friendly Test | https://search.google.com/test/mobile-friendly | Check mobile optimization |\n| Google Search Console | https://search.google.com/search-console | Monitor indexing, coverage, and performance |\n| Google Structured Data Markup Helper | https://www.google.com/webmasters/markup-helper/ | Generate JSON-LD schema code |","tags":["seo","metadata","audit","book2skills","simbajigege","agent-skills","agentskills","anthropic","anthropic-claude","growth-investing","investing","investing-skills"],"capabilities":["skill","source-simbajigege","skill-seo-metadata-audit","topic-agent-skills","topic-agentskills","topic-anthropic","topic-anthropic-claude","topic-book2skills","topic-growth-investing","topic-investing","topic-investing-skills","topic-skills","topic-stock-analysis"],"categories":["book2skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/simbajigege/book2skills/seo-metadata-audit","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add simbajigege/book2skills","source_repo":"https://github.com/simbajigege/book2skills","install_from":"skills.sh"}},"qualityScore":"0.468","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 36 github stars · SKILL.md body (5,455 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T12:56:54.769Z","embedding":null,"createdAt":"2026-04-18T22:22:06.261Z","updatedAt":"2026-05-01T12:56:54.769Z","lastSeenAt":"2026-05-01T12:56:54.769Z","tsv":"'/extension/':167 '/search-console':200 '/test/mobile-friendly':191 '/test/rich-results':180 '/webmasters/markup-helper/':213 '/zh-cn/extension/':154 '1':101 '10':20,67 'aitdk':150 'aitdk.com':153 'aitdk.com/zh-cn/extension/':152 'alt':133 'ask':41,105 'attribut':134,141 'audit':4,10,54,58,89,98 'browser':156 'canon':49,169 'charact':123,127 'check':168,192 'checklist':90 'code':219 'collect':102 'common':94 'comprehens':7 'consol':197 'content':39,121,125 'count':124,128 'coverag':203 'criteria':92 'data':104,183,208 'descript':48,119,159 'detail':85,162 'detailed.com':166 'detailed.com/extension/':165 'document':16,83 'extens':151,164 'extern':138 'extract':108 'follow':110 'framework':74 'free':155 'friend':187 'generat':214 'googl':80,174,184,195,206 'ground':17,76 'head':160 'helper':210 'html':15,23,35,63,115 'imag':132 'import':22,69 'index':202 'json':216 'json-ld':215 'ld':217 'link':139 'mani':137 'markup':209 'meta':24,47,71 'metadata':3,9,44,53,64 'mistak':95 'mobil':186,193 'mobile-friend':185 'monitor':201 'offici':82 'og':170 'optim':194 'page':38,118 'per':87 'per-tag':86 'perform':5,55,205 'plugin':157 'provid':113 'purpos':149 'read':96 'references/tag-reference.md':97 'rel':140 'result':176 'rich':175 'robot':172 'sampl':135 'schema':173,218 'score':91 'search':196 'search.google.com':179,190,199 'search.google.com/search-console':198 'search.google.com/test/mobile-friendly':189 'search.google.com/test/rich-results':178 'searchenginejourn':78 'seo':2,8,43,52,70,163 'seo-metadata-audit':1 'share':32 'skill':28 'skill-seo-metadata-audit' 'sourc':36,116 'source-simbajigege' 'step':100 'structur':57,182,207 'tag':25,46,50,72,88,120,131,142,143,171 'test':177,188 'titl':45,158 'tool':146,147 'topic-agent-skills' 'topic-agentskills' 'topic-anthropic' 'topic-anthropic-claude' 'topic-book2skills' 'topic-growth-investing' 'topic-investing' 'topic-investing-skills' 'topic-skills' 'topic-stock-analysis' 'traffic':161 'url':34,114,148 'use':26,145 'user':31 'valid':181 'webpag':13,61 'whenev':29 'workflow':99 'www.google.com':212 'www.google.com/webmasters/markup-helper/':211","prices":[{"id":"05db1abf-612d-4d47-b847-5398bd647826","listingId":"3d303bdd-cae1-4440-a275-105181d2263d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"simbajigege","category":"book2skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:22:06.261Z"}],"sources":[{"listingId":"3d303bdd-cae1-4440-a275-105181d2263d","source":"github","sourceId":"simbajigege/book2skills/seo-metadata-audit","sourceUrl":"https://github.com/simbajigege/book2skills/tree/main/skills/seo-metadata-audit","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:06.261Z","lastSeenAt":"2026-05-01T12:56:54.769Z"}],"details":{"listingId":"3d303bdd-cae1-4440-a275-105181d2263d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"simbajigege","slug":"seo-metadata-audit","github":{"repo":"simbajigege/book2skills","stars":36,"topics":["agent-skills","agentskills","anthropic","anthropic-claude","book2skills","growth-investing","investing","investing-skills","skills","stock-analysis"],"license":"mit","html_url":"https://github.com/simbajigege/book2skills","pushed_at":"2026-04-30T05:08:07Z","description":"Create best skills based on best books","skill_md_sha":"397ba5bfa1171350d3a07a5e368571cd95b58559","skill_md_path":"skills/seo-metadata-audit/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/simbajigege/book2skills/tree/main/skills/seo-metadata-audit"},"layout":"multi","source":"github","category":"book2skills","frontmatter":{"name":"seo-metadata-audit","license":"Skill distillation for personal/educational use. Do not reproduce source passages verbatim.","description":"Perform a comprehensive SEO metadata audit on any webpage or HTML document, grounded in the 10 most important HTML meta tags. Use this skill whenever the user shares a URL, HTML source, or page content and asks about SEO, metadata, title tags, meta descriptions, canonical tags, schema markup, open graph tags, social sharing, mobile optimization, or why a page might not be ranking well. Also trigger for requests like \"check my SEO\", \"review my page's metadata\", \"audit this site\", \"improve my search ranking\", \"generate an SEO report\", or \"what's wrong with my page's SEO\". When in doubt, use this skill — it's better to run a partial audit than to answer SEO questions without it."},"skills_sh_url":"https://skills.sh/simbajigege/book2skills/seo-metadata-audit"},"updatedAt":"2026-05-01T12:56:54.769Z"}}
![\"Descriptive](\"product.jpg\")
\n\n\nLink Text\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n```\n\n---\n\n## Useful Tools\n\n| Tool | URL | Purpose |\n|---|---|---|\n| AITDK Extension | https://aitdk.com/zh-CN/extension/ | Free browser plugin: Title, Description, Headings, traffic |\n| Detailed SEO Extension | https://detailed.com/extension/ | Check Canonical, OG tags, Robots, Schema |\n| Google Rich Results Test | https://search.google.com/test/rich-results | Validate structured data |\n| Google Mobile-Friendly Test | https://search.google.com/test/mobile-friendly | Check mobile optimization |\n| Google Search Console | https://search.google.com/search-console | Monitor indexing, coverage, and performance |\n| Google Structured Data Markup Helper | https://www.google.com/webmasters/markup-helper/ | Generate JSON-LD schema code |","tags":["seo","metadata","audit","book2skills","simbajigege","agent-skills","agentskills","anthropic","anthropic-claude","growth-investing","investing","investing-skills"],"capabilities":["skill","source-simbajigege","skill-seo-metadata-audit","topic-agent-skills","topic-agentskills","topic-anthropic","topic-anthropic-claude","topic-book2skills","topic-growth-investing","topic-investing","topic-investing-skills","topic-skills","topic-stock-analysis"],"categories":["book2skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/simbajigege/book2skills/seo-metadata-audit","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add simbajigege/book2skills","source_repo":"https://github.com/simbajigege/book2skills","install_from":"skills.sh"}},"qualityScore":"0.468","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 36 github stars · SKILL.md body (5,455 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T12:56:54.769Z","embedding":null,"createdAt":"2026-04-18T22:22:06.261Z","updatedAt":"2026-05-01T12:56:54.769Z","lastSeenAt":"2026-05-01T12:56:54.769Z","tsv":"'/extension/':167 '/search-console':200 '/test/mobile-friendly':191 '/test/rich-results':180 '/webmasters/markup-helper/':213 '/zh-cn/extension/':154 '1':101 '10':20,67 'aitdk':150 'aitdk.com':153 'aitdk.com/zh-cn/extension/':152 'alt':133 'ask':41,105 'attribut':134,141 'audit':4,10,54,58,89,98 'browser':156 'canon':49,169 'charact':123,127 'check':168,192 'checklist':90 'code':219 'collect':102 'common':94 'comprehens':7 'consol':197 'content':39,121,125 'count':124,128 'coverag':203 'criteria':92 'data':104,183,208 'descript':48,119,159 'detail':85,162 'detailed.com':166 'detailed.com/extension/':165 'document':16,83 'extens':151,164 'extern':138 'extract':108 'follow':110 'framework':74 'free':155 'friend':187 'generat':214 'googl':80,174,184,195,206 'ground':17,76 'head':160 'helper':210 'html':15,23,35,63,115 'imag':132 'import':22,69 'index':202 'json':216 'json-ld':215 'ld':217 'link':139 'mani':137 'markup':209 'meta':24,47,71 'metadata':3,9,44,53,64 'mistak':95 'mobil':186,193 'mobile-friend':185 'monitor':201 'offici':82 'og':170 'optim':194 'page':38,118 'per':87 'per-tag':86 'perform':5,55,205 'plugin':157 'provid':113 'purpos':149 'read':96 'references/tag-reference.md':97 'rel':140 'result':176 'rich':175 'robot':172 'sampl':135 'schema':173,218 'score':91 'search':196 'search.google.com':179,190,199 'search.google.com/search-console':198 'search.google.com/test/mobile-friendly':189 'search.google.com/test/rich-results':178 'searchenginejourn':78 'seo':2,8,43,52,70,163 'seo-metadata-audit':1 'share':32 'skill':28 'skill-seo-metadata-audit' 'sourc':36,116 'source-simbajigege' 'step':100 'structur':57,182,207 'tag':25,46,50,72,88,120,131,142,143,171 'test':177,188 'titl':45,158 'tool':146,147 'topic-agent-skills' 'topic-agentskills' 'topic-anthropic' 'topic-anthropic-claude' 'topic-book2skills' 'topic-growth-investing' 'topic-investing' 'topic-investing-skills' 'topic-skills' 'topic-stock-analysis' 'traffic':161 'url':34,114,148 'use':26,145 'user':31 'valid':181 'webpag':13,61 'whenev':29 'workflow':99 'www.google.com':212 'www.google.com/webmasters/markup-helper/':211","prices":[{"id":"05db1abf-612d-4d47-b847-5398bd647826","listingId":"3d303bdd-cae1-4440-a275-105181d2263d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"simbajigege","category":"book2skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:22:06.261Z"}],"sources":[{"listingId":"3d303bdd-cae1-4440-a275-105181d2263d","source":"github","sourceId":"simbajigege/book2skills/seo-metadata-audit","sourceUrl":"https://github.com/simbajigege/book2skills/tree/main/skills/seo-metadata-audit","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:06.261Z","lastSeenAt":"2026-05-01T12:56:54.769Z"}],"details":{"listingId":"3d303bdd-cae1-4440-a275-105181d2263d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"simbajigege","slug":"seo-metadata-audit","github":{"repo":"simbajigege/book2skills","stars":36,"topics":["agent-skills","agentskills","anthropic","anthropic-claude","book2skills","growth-investing","investing","investing-skills","skills","stock-analysis"],"license":"mit","html_url":"https://github.com/simbajigege/book2skills","pushed_at":"2026-04-30T05:08:07Z","description":"Create best skills based on best books","skill_md_sha":"397ba5bfa1171350d3a07a5e368571cd95b58559","skill_md_path":"skills/seo-metadata-audit/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/simbajigege/book2skills/tree/main/skills/seo-metadata-audit"},"layout":"multi","source":"github","category":"book2skills","frontmatter":{"name":"seo-metadata-audit","license":"Skill distillation for personal/educational use. Do not reproduce source passages verbatim.","description":"Perform a comprehensive SEO metadata audit on any webpage or HTML document, grounded in the 10 most important HTML meta tags. Use this skill whenever the user shares a URL, HTML source, or page content and asks about SEO, metadata, title tags, meta descriptions, canonical tags, schema markup, open graph tags, social sharing, mobile optimization, or why a page might not be ranking well. Also trigger for requests like \"check my SEO\", \"review my page's metadata\", \"audit this site\", \"improve my search ranking\", \"generate an SEO report\", or \"what's wrong with my page's SEO\". When in doubt, use this skill — it's better to run a partial audit than to answer SEO questions without it."},"skills_sh_url":"https://skills.sh/simbajigege/book2skills/seo-metadata-audit"},"updatedAt":"2026-05-01T12:56:54.769Z"}}