@su-record/vibe 2.9.23 → 2.9.25

package/skills/priority-todos/templates/todo-board.md

@@ -1,59 +1,59 @@
-# TODO Board: {{PROJECT_OR_FEATURE_NAME}}
-
-**Updated**: {{DATE}}
-**Branch**: {{GIT_BRANCH}}
-**Total open**: {{TOTAL_OPEN}} | P1: {{P1_COUNT}} | P2: {{P2_COUNT}} | P3: {{P3_COUNT}}
-
----
-
-## P1 — Blocks Merge ({{P1_COUNT}} open)
-
-> All P1 items must be resolved before this branch can be merged.
-
-| ID | Title | File:Line | Assigned | Status |
-|----|-------|-----------|----------|--------|
-| P1-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{ASSIGNEE_1}} | {{STATUS_1}} |
-| P1-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{ASSIGNEE_2}} | {{STATUS_2}} |
-
-{{#if P1_EMPTY}}
-_No P1 items. Merge is unblocked._
-{{/if}}
-
----
-
-## P2 — Fix Before PR ({{P2_COUNT}} open)
-
-> P2 items should be resolved before PR review. Warning only — does not block merge.
-
-| ID | Title | File:Line | Assigned | Status |
-|----|-------|-----------|----------|--------|
-| P2-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{ASSIGNEE_1}} | {{STATUS_1}} |
-| P2-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{ASSIGNEE_2}} | {{STATUS_2}} |
-
----
-
-## P3 — Backlog ({{P3_COUNT}} open)
-
-> P3 items do not block merge. Address during scheduled cleanup sessions.
-
-| ID | Title | File:Line | Notes |
-|----|-------|-----------|-------|
-| P3-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{NOTES_1}} |
-| P3-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{NOTES_2}} |
-
----
-
-## Completed (archived)
-
-| ID | Title | Resolved | PR/Commit |
-|----|-------|----------|-----------|
-| {{DONE_ID_1}} | {{DONE_TITLE_1}} | {{DONE_DATE_1}} | {{DONE_REF_1}} |
-
----
-
-## Merge Checklist
-
-- [ ] P1 count = 0
-- [ ] P2 items reviewed (resolved or documented)
-- [ ] index.md reflects current state
-- [ ] Completed items archived to `done/`
+# TODO Board: {{PROJECT_OR_FEATURE_NAME}}
+
+**Updated**: {{DATE}}
+**Branch**: {{GIT_BRANCH}}
+**Total open**: {{TOTAL_OPEN}} | P1: {{P1_COUNT}} | P2: {{P2_COUNT}} | P3: {{P3_COUNT}}
+
+---
+
+## P1 — Blocks Merge ({{P1_COUNT}} open)
+
+> All P1 items must be resolved before this branch can be merged.
+
+| ID | Title | File:Line | Assigned | Status |
+|----|-------|-----------|----------|--------|
+| P1-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{ASSIGNEE_1}} | {{STATUS_1}} |
+| P1-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{ASSIGNEE_2}} | {{STATUS_2}} |
+
+{{#if P1_EMPTY}}
+_No P1 items. Merge is unblocked._
+{{/if}}
+
+---
+
+## P2 — Fix Before PR ({{P2_COUNT}} open)
+
+> P2 items should be resolved before PR review. Warning only — does not block merge.
+
+| ID | Title | File:Line | Assigned | Status |
+|----|-------|-----------|----------|--------|
+| P2-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{ASSIGNEE_1}} | {{STATUS_1}} |
+| P2-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{ASSIGNEE_2}} | {{STATUS_2}} |
+
+---
+
+## P3 — Backlog ({{P3_COUNT}} open)
+
+> P3 items do not block merge. Address during scheduled cleanup sessions.
+
+| ID | Title | File:Line | Notes |
+|----|-------|-----------|-------|
+| P3-{{ID_1}} | {{TITLE_1}} | `{{FILE_1}}:{{LINE_1}}` | {{NOTES_1}} |
+| P3-{{ID_2}} | {{TITLE_2}} | `{{FILE_2}}:{{LINE_2}}` | {{NOTES_2}} |
+
+---
+
+## Completed (archived)
+
+| ID | Title | Resolved | PR/Commit |
+|----|-------|----------|-----------|
+| {{DONE_ID_1}} | {{DONE_TITLE_1}} | {{DONE_DATE_1}} | {{DONE_REF_1}} |
+
+---
+
+## Merge Checklist
+
+- [ ] P1 count = 0
+- [ ] P2 items reviewed (resolved or documented)
+- [ ] index.md reflects current state
+- [ ] Completed items archived to `done/`

package/skills/seo-checklist/SKILL.md

@@ -1,58 +1,58 @@
----
-name: seo-checklist
-tier: core
-description: "SEO gotchas for web development — easy-to-miss items that hurt search ranking. Covers meta tags, Open Graph, structured data (JSON-LD), sitemap, robots.txt, canonical URLs, and Naver/Google-specific requirements. Use when building or reviewing any public-facing web page, landing page, or marketing site. Must use this skill when user mentions SEO, search ranking, meta tags, or when deploying a web app that needs to be discoverable."
-triggers: [seo, search, meta, sitemap, schema, structured data, og, opengraph, google, naver]
-priority: 65
----
-
-# SEO Checklist
-
-## Pre-check (K1)
-
-> Is this a public-facing web page that needs search visibility? Internal tools, admin panels, and authenticated-only pages don't need SEO optimization.
-
-## Easy-to-Miss Gotchas
-
-### Meta & Social
-
-| Gotcha | Why It Hurts | Fix |
-|--------|-------------|-----|
-| Missing `<link rel="canonical">` | Duplicate content penalty from URL variants | Set canonical on every page, including paginated |
-| OG image wrong size | Cropped/pixelated on social share | Must be exactly **1200x630px** |
-| Same title/description on all pages | Google treats as duplicate content | Unique title (50-60 chars) + description (150-160 chars) per page |
-| Missing `og:type` | Defaults to "website" for articles | Set `article` for posts, `product` for products |
-
-### Technical
-
-| Gotcha | Why It Hurts | Fix |
-|--------|-------------|-----|
-| `robots.txt` blocks important pages | Pages not indexed | `Allow: /` for public, only block `/api/`, `/admin/` |
-| No sitemap or stale sitemap | Crawler misses new pages | Auto-generate, include `<lastmod>` with real dates |
-| `noindex` left in production | Entire site invisible | Verify `<meta name="robots">` in production build |
-| Images without `width`/`height` | CLS layout shift penalty | Always set dimensions + `loading="lazy"` for below-fold |
-
-### Core Web Vitals
-
-| Metric | Target | Common Miss |
-|--------|--------|-------------|
-| LCP | ≤2.5s | Hero image not preloaded — add `<link rel="preload">` |
-| INP | ≤200ms | Heavy JS on interaction — defer non-critical scripts |
-| CLS | ≤0.1 | Dynamic content without reserved space — set `min-height` |
-
-### Structured Data
-
-| Gotcha | Fix |
-|--------|-----|
-| JSON-LD not validated | Test with Google Rich Results Test before deploy |
-| Wrong `@type` | `Product` for products, `Article` for posts, `FAQPage` for FAQs |
-| Missing `BreadcrumbList` | Add breadcrumb schema for all non-root pages |
-
-## Done Criteria (K4)
-
-- [ ] Every page has unique title, description, canonical URL
-- [ ] OG images are 1200x630px on all shareable pages
-- [ ] `robots.txt` and `sitemap.xml` present and correct
-- [ ] Structured data validates in Rich Results Test
-- [ ] Core Web Vitals green (LCP ≤2.5s, INP ≤200ms, CLS ≤0.1)
-- [ ] No `noindex` tags in production
+---
+name: seo-checklist
+tier: core
+description: "SEO gotchas for web development — easy-to-miss items that hurt search ranking. Covers meta tags, Open Graph, structured data (JSON-LD), sitemap, robots.txt, canonical URLs, and Naver/Google-specific requirements. Use when building or reviewing any public-facing web page, landing page, or marketing site. Must use this skill when user mentions SEO, search ranking, meta tags, or when deploying a web app that needs to be discoverable."
+triggers: [seo, search, meta, sitemap, schema, structured data, og, opengraph, google, naver]
+priority: 65
+---
+
+# SEO Checklist
+
+## Pre-check (K1)
+
+> Is this a public-facing web page that needs search visibility? Internal tools, admin panels, and authenticated-only pages don't need SEO optimization.
+
+## Easy-to-Miss Gotchas
+
+### Meta & Social
+
+| Gotcha | Why It Hurts | Fix |
+|--------|-------------|-----|
+| Missing `<link rel="canonical">` | Duplicate content penalty from URL variants | Set canonical on every page, including paginated |
+| OG image wrong size | Cropped/pixelated on social share | Must be exactly **1200x630px** |
+| Same title/description on all pages | Google treats as duplicate content | Unique title (50-60 chars) + description (150-160 chars) per page |
+| Missing `og:type` | Defaults to "website" for articles | Set `article` for posts, `product` for products |
+
+### Technical
+
+| Gotcha | Why It Hurts | Fix |
+|--------|-------------|-----|
+| `robots.txt` blocks important pages | Pages not indexed | `Allow: /` for public, only block `/api/`, `/admin/` |
+| No sitemap or stale sitemap | Crawler misses new pages | Auto-generate, include `<lastmod>` with real dates |
+| `noindex` left in production | Entire site invisible | Verify `<meta name="robots">` in production build |
+| Images without `width`/`height` | CLS layout shift penalty | Always set dimensions + `loading="lazy"` for below-fold |
+
+### Core Web Vitals
+
+| Metric | Target | Common Miss |
+|--------|--------|-------------|
+| LCP | ≤2.5s | Hero image not preloaded — add `<link rel="preload">` |
+| INP | ≤200ms | Heavy JS on interaction — defer non-critical scripts |
+| CLS | ≤0.1 | Dynamic content without reserved space — set `min-height` |
+
+### Structured Data
+
+| Gotcha | Fix |
+|--------|-----|
+| JSON-LD not validated | Test with Google Rich Results Test before deploy |
+| Wrong `@type` | `Product` for products, `Article` for posts, `FAQPage` for FAQs |
+| Missing `BreadcrumbList` | Add breadcrumb schema for all non-root pages |
+
+## Done Criteria (K4)
+
+- [ ] Every page has unique title, description, canonical URL
+- [ ] OG images are 1200x630px on all shareable pages
+- [ ] `robots.txt` and `sitemap.xml` present and correct
+- [ ] Structured data validates in Rich Results Test
+- [ ] Core Web Vitals green (LCP ≤2.5s, INP ≤200ms, CLS ≤0.1)
+- [ ] No `noindex` tags in production

package/skills/seo-checklist/frameworks/structured-data.md

@@ -1,153 +1,153 @@
----
-name: structured-data
-type: framework
-applies-to: [seo-checklist]
-format: JSON-LD
----
-
-# Structured Data — JSON-LD Schema Templates
-
-Embed in `<script type="application/ld+json">` in `<head>` or before `</body>`.
-
-## Article
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "Article",
-  "headline": "Article Title (max 110 chars)",
-  "description": "Article summary (max 160 chars)",
-  "image": "https://example.com/article-image.jpg",
-  "author": {
-    "@type": "Person",
-    "name": "Author Name",
-    "url": "https://example.com/authors/name"
-  },
-  "publisher": {
-    "@type": "Organization",
-    "name": "Publisher Name",
-    "logo": {
-      "@type": "ImageObject",
-      "url": "https://example.com/logo.png"
-    }
-  },
-  "datePublished": "2024-01-15T08:00:00+00:00",
-  "dateModified": "2024-01-20T10:00:00+00:00",
-  "mainEntityOfPage": {
-    "@type": "WebPage",
-    "@id": "https://example.com/article-slug"
-  }
-}
-```
-
-**Required by Google**: `headline`, `image`, `datePublished`, `author`
-
-## Product
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "Product",
-  "name": "Product Name",
-  "description": "Product description",
-  "image": ["https://example.com/product-1.jpg", "https://example.com/product-2.jpg"],
-  "sku": "PROD-123",
-  "brand": {
-    "@type": "Brand",
-    "name": "Brand Name"
-  },
-  "offers": {
-    "@type": "Offer",
-    "url": "https://example.com/product",
-    "priceCurrency": "USD",
-    "price": "29.99",
-    "availability": "https://schema.org/InStock",
-    "itemCondition": "https://schema.org/NewCondition"
-  },
-  "aggregateRating": {
-    "@type": "AggregateRating",
-    "ratingValue": "4.5",
-    "reviewCount": "127"
-  }
-}
-```
-
-**Required by Google**: `name` + one of `review`, `aggregateRating`, or `offers`
-
-## FAQ
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "FAQPage",
-  "mainEntity": [
-    {
-      "@type": "Question",
-      "name": "What is the return policy?",
-      "acceptedAnswer": {
-        "@type": "Answer",
-        "text": "We accept returns within 30 days of purchase. Items must be unused and in original packaging."
-      }
-    },
-    {
-      "@type": "Question",
-      "name": "How long does shipping take?",
-      "acceptedAnswer": {
-        "@type": "Answer",
-        "text": "Standard shipping takes 3-5 business days. Express shipping is available for 1-2 day delivery."
-      }
-    }
-  ]
-}
-```
-
-**Note**: Each Q&A must appear as visible content on the page. Do not use for ad content.
-
-## BreadcrumbList
-
-```json
-{
-  "@context": "https://schema.org",
-  "@type": "BreadcrumbList",
-  "itemListElement": [
-    {
-      "@type": "ListItem",
-      "position": 1,
-      "name": "Home",
-      "item": "https://example.com"
-    },
-    {
-      "@type": "ListItem",
-      "position": 2,
-      "name": "Category",
-      "item": "https://example.com/category"
-    },
-    {
-      "@type": "ListItem",
-      "position": 3,
-      "name": "Product Name",
-      "item": "https://example.com/category/product"
-    }
-  ]
-}
-```
-
-**Note**: `position` must be sequential starting at 1. Last item does not require `item` URL.
-
-## Validation
-
-| Tool | URL |
-|------|-----|
-| Google Rich Results Test | https://search.google.com/test/rich-results |
-| Schema.org Validator | https://validator.schema.org |
-| Chrome DevTools → Network | Filter for `application/ld+json` |
-
-## Common Mistakes
-
-| Mistake | Fix |
-|---------|-----|
-| Price without currency | Always include `priceCurrency` with `price` |
-| Missing `datePublished` on Article | Required for Google News eligibility |
-| FAQ content not visible on page | Google penalizes hidden Q&A markup |
-| Breadcrumb positions not sequential | Use 1, 2, 3 — no skipping |
-| Image URL not absolute | Always use full `https://` URLs |
+---
+name: structured-data
+type: framework
+applies-to: [seo-checklist]
+format: JSON-LD
+---
+
+# Structured Data — JSON-LD Schema Templates
+
+Embed in `<script type="application/ld+json">` in `<head>` or before `</body>`.
+
+## Article
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "Article Title (max 110 chars)",
+  "description": "Article summary (max 160 chars)",
+  "image": "https://example.com/article-image.jpg",
+  "author": {
+    "@type": "Person",
+    "name": "Author Name",
+    "url": "https://example.com/authors/name"
+  },
+  "publisher": {
+    "@type": "Organization",
+    "name": "Publisher Name",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "https://example.com/logo.png"
+    }
+  },
+  "datePublished": "2024-01-15T08:00:00+00:00",
+  "dateModified": "2024-01-20T10:00:00+00:00",
+  "mainEntityOfPage": {
+    "@type": "WebPage",
+    "@id": "https://example.com/article-slug"
+  }
+}
+```
+
+**Required by Google**: `headline`, `image`, `datePublished`, `author`
+
+## Product
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Product",
+  "name": "Product Name",
+  "description": "Product description",
+  "image": ["https://example.com/product-1.jpg", "https://example.com/product-2.jpg"],
+  "sku": "PROD-123",
+  "brand": {
+    "@type": "Brand",
+    "name": "Brand Name"
+  },
+  "offers": {
+    "@type": "Offer",
+    "url": "https://example.com/product",
+    "priceCurrency": "USD",
+    "price": "29.99",
+    "availability": "https://schema.org/InStock",
+    "itemCondition": "https://schema.org/NewCondition"
+  },
+  "aggregateRating": {
+    "@type": "AggregateRating",
+    "ratingValue": "4.5",
+    "reviewCount": "127"
+  }
+}
+```
+
+**Required by Google**: `name` + one of `review`, `aggregateRating`, or `offers`
+
+## FAQ
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "mainEntity": [
+    {
+      "@type": "Question",
+      "name": "What is the return policy?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "We accept returns within 30 days of purchase. Items must be unused and in original packaging."
+      }
+    },
+    {
+      "@type": "Question",
+      "name": "How long does shipping take?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "Standard shipping takes 3-5 business days. Express shipping is available for 1-2 day delivery."
+      }
+    }
+  ]
+}
+```
+
+**Note**: Each Q&A must appear as visible content on the page. Do not use for ad content.
+
+## BreadcrumbList
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "BreadcrumbList",
+  "itemListElement": [
+    {
+      "@type": "ListItem",
+      "position": 1,
+      "name": "Home",
+      "item": "https://example.com"
+    },
+    {
+      "@type": "ListItem",
+      "position": 2,
+      "name": "Category",
+      "item": "https://example.com/category"
+    },
+    {
+      "@type": "ListItem",
+      "position": 3,
+      "name": "Product Name",
+      "item": "https://example.com/category/product"
+    }
+  ]
+}
+```
+
+**Note**: `position` must be sequential starting at 1. Last item does not require `item` URL.
+
+## Validation
+
+| Tool | URL |
+|------|-----|
+| Google Rich Results Test | https://search.google.com/test/rich-results |
+| Schema.org Validator | https://validator.schema.org |
+| Chrome DevTools → Network | Filter for `application/ld+json` |
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Price without currency | Always include `priceCurrency` with `price` |
+| Missing `datePublished` on Article | Required for Google News eligibility |
+| FAQ content not visible on page | Google penalizes hidden Q&A markup |
+| Breadcrumb positions not sequential | Use 1, 2, 3 — no skipping |
+| Image URL not absolute | Always use full `https://` URLs |

package/skills/seo-checklist/rubrics/content-seo.md

@@ -1,42 +1,42 @@
-# Content SEO Checklist
-
-## Heading Structure
-
-- [ ] Single `<h1>` per page — matches primary keyword intent
-- [ ] Logical hierarchy: `h1 → h2 → h3` (no skipping levels)
-- [ ] `<h2>` tags cover major subtopics (crawlers use for content outline)
-- [ ] No headings used purely for styling — use CSS classes instead
-
-## Keyword Placement
-
-- [ ] Primary keyword in `<title>`, `<h1>`, first 100 words of body
-- [ ] Secondary keywords in `<h2>` tags and body naturally
-- [ ] Keyword in image `alt` text where relevant (descriptive, not stuffed)
-- [ ] URL slug contains primary keyword (lowercase, hyphens, no stop words)
-
-## Internal Linking
-
-- [ ] Every important page reachable within 3 clicks from homepage
-- [ ] Anchor text is descriptive ("authentication guide") not generic ("click here")
-- [ ] New content links back to related existing content
-- [ ] Orphan pages (no inbound internal links) have at least one link added
-
-## Content Quality Signals
-
-- [ ] Word count appropriate for topic depth (informational: 1000+, landing: 300-600)
-- [ ] No duplicate content across pages — each URL has unique value
-- [ ] Pagination uses `rel="next"` / `rel="prev"` or canonical to main page
-- [ ] Thin content pages (< 300 words) either expanded or `noindex` applied
-
-## Images & Media
-
-- [ ] Every `<img>` has descriptive `alt` text (empty `alt=""` for decorative images)
-- [ ] File names descriptive: `product-dashboard-screenshot.webp` not `IMG_4821.jpg`
-- [ ] Use WebP or AVIF format where possible
-- [ ] Videos have transcript or caption for accessibility and crawlability
-
-## Localization (if applicable)
-
-- [ ] `hreflang` tags on all translated pages
-- [ ] Each locale version has its own canonical URL
-- [ ] `hreflang` includes `x-default` for language selector page
+# Content SEO Checklist
+
+## Heading Structure
+
+- [ ] Single `<h1>` per page — matches primary keyword intent
+- [ ] Logical hierarchy: `h1 → h2 → h3` (no skipping levels)
+- [ ] `<h2>` tags cover major subtopics (crawlers use for content outline)
+- [ ] No headings used purely for styling — use CSS classes instead
+
+## Keyword Placement
+
+- [ ] Primary keyword in `<title>`, `<h1>`, first 100 words of body
+- [ ] Secondary keywords in `<h2>` tags and body naturally
+- [ ] Keyword in image `alt` text where relevant (descriptive, not stuffed)
+- [ ] URL slug contains primary keyword (lowercase, hyphens, no stop words)
+
+## Internal Linking
+
+- [ ] Every important page reachable within 3 clicks from homepage
+- [ ] Anchor text is descriptive ("authentication guide") not generic ("click here")
+- [ ] New content links back to related existing content
+- [ ] Orphan pages (no inbound internal links) have at least one link added
+
+## Content Quality Signals
+
+- [ ] Word count appropriate for topic depth (informational: 1000+, landing: 300-600)
+- [ ] No duplicate content across pages — each URL has unique value
+- [ ] Pagination uses `rel="next"` / `rel="prev"` or canonical to main page
+- [ ] Thin content pages (< 300 words) either expanded or `noindex` applied
+
+## Images & Media
+
+- [ ] Every `<img>` has descriptive `alt` text (empty `alt=""` for decorative images)
+- [ ] File names descriptive: `product-dashboard-screenshot.webp` not `IMG_4821.jpg`
+- [ ] Use WebP or AVIF format where possible
+- [ ] Videos have transcript or caption for accessibility and crawlability
+
+## Localization (if applicable)
+
+- [ ] `hreflang` tags on all translated pages
+- [ ] Each locale version has its own canonical URL
+- [ ] `hreflang` includes `x-default` for language selector page