fixing-metadata
installsforks
How to install fixing-metadata?
ibelick/ui-skills/fixing-metadata
$npx -y skills add ibelick/ui-skills --skill fixing-metadataAudit and fix HTML metadata including page titles, meta descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, JSON-LD structured data, and robots directives. Use when adding SEO metadata, fixing social share previews, reviewing Open Graph tags, setting up canoni
SKILL.md
| 1 | ## Workflow |
| 2 | |
| 3 | 1. Identify pages with missing or incorrect metadata (titles, descriptions, canonical, OG tags) |
| 4 | 2. Audit against the priority rules below — fix critical issues (duplicates, indexing) first |
| 5 | 3. Ensure title, description, canonical, and og:url all agree with each other |
| 6 | 4. Verify social cards render correctly on a real URL, not localhost |
| 7 | 5. Keep diffs minimal and scoped to metadata only — do not refactor unrelated code |
| 8 | ## when to apply |
| 9 | |
| 10 | Reference these guidelines when: |
| 11 | - adding or changing page titles, descriptions, canonical, robots |
| 12 | - implementing Open Graph or Twitter card metadata |
| 13 | - setting favicons, app icons, manifest, theme-color |
| 14 | - building shared SEO components or layout metadata defaults |
| 15 | - adding structured data (JSON-LD) |
| 16 | - changing locale, alternate languages, or canonical routing |
| 17 | - shipping new pages, marketing pages, or shareable links |
| 18 | |
| 19 | ## rule categories by priority |
| 20 | |
| 21 | | priority | category | impact | |
| 22 | |----------|----------|--------| |
| 23 | | 1 | correctness and duplication | critical | |
| 24 | | 2 | title and description | high | |
| 25 | | 3 | canonical and indexing | high | |
| 26 | | 4 | social cards | high | |
| 27 | | 5 | icons and manifest | medium | |
| 28 | | 6 | structured data | medium | |
| 29 | | 7 | locale and alternates | low-medium | |
| 30 | | 8 | tool boundaries | critical | |
| 31 | |
| 32 | ## quick reference |
| 33 | |
| 34 | ### 1. correctness and duplication (critical) |
| 35 | |
| 36 | - define metadata in one place per page, avoid competing systems |
| 37 | - do not emit duplicate title, description, canonical, or robots tags |
| 38 | - metadata must be deterministic, no random or unstable values |
| 39 | - escape and sanitize any user-generated or dynamic strings |
| 40 | - every page must have safe defaults for title and description |
| 41 | |
| 42 | ### 2. title and description (high) |
| 43 | |
| 44 | - every page must have a title |
| 45 | - use a consistent title format across the site |
| 46 | - keep titles short and readable, avoid stuffing |
| 47 | - shareable or searchable pages should have a meta description |
| 48 | - descriptions must be plain text, no markdown or quote spam |
| 49 | |
| 50 | ### 3. canonical and indexing (high) |
| 51 | |
| 52 | - canonical must point to the preferred URL for the page |
| 53 | - use noindex only for private, duplicate, or non-public pages |
| 54 | - robots meta must match actual access intent |
| 55 | - previews or staging pages should be noindex by default when possible |
| 56 | - paginated pages must have correct canonical behavior |
| 57 | |
| 58 | ### 4. social cards (high) |
| 59 | |
| 60 | - shareable pages must set Open Graph title, description, and image |
| 61 | - Open Graph and Twitter images must use absolute URLs |
| 62 | - prefer correct image dimensions and stable aspect ratios |
| 63 | - og:url must match the canonical URL |
| 64 | - use a sensible og:type, usually website or article |
| 65 | - set twitter:card appropriately, summary_large_image by default |
| 66 | |
| 67 | ### 5. icons and manifest (medium) |
| 68 | |
| 69 | - include at least one favicon that works across browsers |
| 70 | - include apple-touch-icon when relevant |
| 71 | - manifest must be valid and referenced when used |
| 72 | - set theme-color intentionally to avoid mismatched UI chrome |
| 73 | - icon paths should be stable and cacheable |
| 74 | |
| 75 | ### 6. structured data (medium) |
| 76 | |
| 77 | - do not add JSON-LD unless it clearly maps to real page content |
| 78 | - JSON-LD must be valid and reflect what is actually rendered |
| 79 | - do not invent ratings, reviews, prices, or organization details |
| 80 | - prefer one structured data block per page unless required |
| 81 | |
| 82 | ### 7. locale and alternates (low-medium) |
| 83 | |
| 84 | - set the html lang attribute correctly |
| 85 | - set og:locale when localization exists |
| 86 | - add hreflang alternates only when pages truly exist |
| 87 | - localized pages must canonicalize correctly per locale |
| 88 | |
| 89 | ### 8. tool boundaries (critical) |
| 90 | |
| 91 | - prefer minimal changes, do not refactor unrelated code |
| 92 | - do not migrate frameworks or SEO libraries unless requested |
| 93 | - follow the project's existing metadata pattern (Next.js metadata API, react-helmet, manual head, etc.) |
| 94 | |
| 95 | ## review guidance |
| 96 | |
| 97 | - fix critical issues first (duplicates, canonical, indexing) |
| 98 | - ensure title, description, canonical, and og:url agree |
| 99 | - verify social cards on a real URL, not localhost |
| 100 | - prefer stable, boring metadata over clever or dynamic |
| 101 | - keep diffs minimal and scoped to metadata only |
People who liked this also viewed
6 picksType
- web-design-guidelinesReview UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".SkillsJul 2026
- lark-slides飞书幻灯片：创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。当用户给出 doubao.com 的 /slides/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URL 路径模式和 token，而不是域名。不负责：云文档内容编辑（走 SkillsJul 2026
- design-taste-frontendTaste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop SkillsJul 2026
- ui-ux-pro-maxUI/UX design intelligence for web and mobile. Searchable local database with 84 styles, 192 color palettes, 74 font pairings, 192 product types, 98 UX guidelines, 104 icon entries, 16 GSAP motion presSkillsJul 2026
- caveman-helpQuick-reference card for all caveman modes, skills, and commands. One-shot display, not a persistent mode. Trigger: /caveman-help, "caveman help", "what caveman commands", "how do I use caveman".SkillsJul 2026
- codebase-designShared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-nSkillsJul 2026
