schema-markup
作者 alirezarezvanischema-markup skill 可協助 agent 規劃、撰寫、稽核並驗證用於 rich results 的 JSON-LD。適合在 Technical SEO 工作流程中處理 Article、FAQPage、HowTo、Product、LocalBusiness、Organization 與 BreadcrumbList markup，並提供 implementation patterns、schema type 指引，以及 Python validator script。
此 skill 評分為 84/100，代表它很適合收錄給希望讓 agent 實作、稽核或驗證 schema markup 的目錄使用者；相較一般 SEO prompt，它能減少許多猜測。此 repository 提供清楚的啟用條件、可重用範本、schema type 指引與 validator script。不過若能補上明確安裝說明，並更清楚界定本機 validator 能證明與不能證明的範圍，採用門檻會更低。
- frontmatter 的觸發條件非常清楚，包含 structured data、JSON-LD、rich results、FAQ/Product/HowTo schema 等正向觸發，也明確排除一般 SEO 或 crawl audits。
- 實作內容相當完整：SKILL.md 定義了情境蒐集、實作／稽核／驗證等使用情境，也說明何時應先參考 product marketing context 再提問。
- 支援素材實用，包含 schema type 指引、可直接複製貼上的 JSON-LD implementation patterns，以及可從 HTML 擷取並驗證 JSON-LD 的 Python script。
- skill 路徑下沒有提供安裝指令或 README，因此目錄使用者必須依據整個 repository 的慣例自行推斷安裝方式。
- 內附 validator 可在本機評分必填／建議欄位的覆蓋度，但參考資料仍要求使用 Google Rich Results 測試；它不能取代官方的複合式搜尋結果驗證。
schema-markup skill 概覽
schema-markup 的用途
schema-markup skill 可協助 AI agent 規劃、撰寫、稽核與驗證 JSON-LD 結構化資料，適用於需要提升 Google 複合式搜尋結果資格、並為 AI search 提供更清楚機器可讀脈絡的頁面。它是為技術 SEO 工作而設計；交付內容不是廣泛的網站稽核，而是可落地的 schema markup，例如 Article、BlogPosting、FAQPage、HowTo、Product、LocalBusiness、Organization、BreadcrumbList，以及相關的 schema.org 類型。
最適合使用這個 skill 的情境
當你已經知道頁面類型或問題時，很適合使用這個 schema-markup skill，例如缺少 FAQ schema、Product markup 錯誤、Article 複合式搜尋結果資格、Search Console 結構化資料警告，或需要在 CMS 中標準化 JSON-LD。它特別適合行銷人員、SEO 專家、開發者與內容團隊：你需要的是可直接實作的 JSON-LD 與驗證指引，而不是 schema.org 的泛泛說明。
它和一般 prompt 有什麼不同
這個 repository 內含實務參考資料、可直接套用的實作模式，以及 Python validator script。這很重要，因為 schema 工作常常敗在細節：絕對路徑圖片 URL、必填屬性、與頁面可見內容一致、publisher logos、ISO 日期，以及 CMS 注入限制。這個 skill 會先引導 agent 進行結構化需求蒐集，再產生 markup，降低產出看似合理但實際無效的 JSON-LD 風險。
不適合使用的時機
不要把 schema-markup 當成完整技術爬站、JavaScript rendering 診斷、內部連結檢查或網站架構稽核的替代品。如果真正的問題是可索引性、canonicals、crawl depth，或 template rendering，應先使用更完整的 SEO 或網站架構工作流程；等目標頁面與 templates 穩定後，再回到 schema 處理。
如何使用 schema-markup skill
schema-markup 安裝與優先檢查的檔案
使用以下指令安裝 skill：
npx skills add alirezarezvani/claude-skills --skill schema-markup
安裝後，請先閱讀 marketing-skill/skills/schema-markup/SKILL.md，了解觸發規則與需求蒐集流程。接著檢查 references/schema-types-guide.md，用來判斷類型選擇與必填欄位；查看 references/implementation-patterns.md 取得 JSON-LD 範例；如果你想在本機快速檢查必填與建議欄位，也可以看 scripts/schema_validator.py。
產生 JSON-LD 前需要提供的輸入
若要把 schema-markup 用得更準，請提供頁面層級的事實，而不只是說「加 schema」。建議包含：
- Page URL 與 canonical URL
- Page type，例如 product、article、FAQ、local business、how-to 或 category
- 頁面可見 title、author、publish 與 modified dates
- 主要 image URL 與尺寸
- Organization name、logo URL 與 sameAs profiles
- 視情況提供 Product price、availability、SKU、reviews 或 offers
- CMS 或實作方式，例如 WordPress plugin、Webflow custom code、Shopify theme，或可直接存取
<head> - 既有 Search Console errors 或 rich result test messages
較弱的 prompt 是：「Create schema for this page。」
更好的 prompt 是：「Use the schema-markup skill to create JSON-LD for this BlogPosting page. URL: https://example.com/blog/schema-guide. H1: Schema Markup Guide. Author: Jane Smith. Published: 2026-02-10. Modified: 2026-03-01. Image: https://example.com/images/schema-guide.jpg, 1200x630. Publisher logo: https://example.com/logo.png, 250x60. Match visible page content and flag any missing fields before writing final JSON-LD。」
實作時的實務流程
先從既有 markup 稽核開始。查看 page source、檢查 Search Console 結構化資料報告，或儲存 rendered HTML 後執行 python3 scripts/schema_validator.py page.html。接著請 skill 分類頁面類型，並選擇最精準、有效的 schema type。例如，部落格文章通常應使用 BlogPosting，而交易型商品頁則需要包含 offers 的 Product。
下一步是產生 JSON-LD，逐一比對每個屬性是否與頁面可見內容相符，並在部署前使用 Google Rich Results Test 測試。部署後，再重新測試 live URL 並監控 Search Console。這個 skill 可以協助解讀驗證訊息，但無法保證一定出現複合式搜尋結果；Google eligibility 仍取決於內容品質、政策遵循、可爬取性與搜尋需求。
提升輸出品質的技巧
請要求「implementation-ready JSON-LD plus missing-field notes」。這能避免 agent 默默捏造不存在的資料。若是 templates，請要求可重複使用、含變數的模式，例如 {{ product.title }} 或 {{ article.published_at }}。若是受規範管制或高度重視信任的頁面，請要求保守版本，只標記頁面上清楚可見的內容。若是 multi-schema 頁面，請要求 skill 使用穩定的 @id 值連結各實體，讓 Organization、WebPage、BreadcrumbList 與 Article 資料不會看起來彼此斷開。
schema-markup skill 常見問題
schema-markup 適合新手嗎？
適合，前提是你能蒐集頁面事實並測試輸出。參考資料會說明常見 schema types 的用途、哪些欄位重要，以及哪些錯誤會阻礙 eligibility。新手建議從單一頁面類型開始，例如 Article 或 FAQPage；先驗證成功，再把已驗證的模式擴展到 templates。
它可以修正 Search Console 結構化資料錯誤嗎？
它可以協助解讀並修正許多結構化資料錯誤，特別是缺少必填屬性、JSON-LD 格式錯誤、schema type 錯誤，以及 Product 或 Article 欄位不完整。不過，若錯誤來自無法存取的頁面、被封鎖的 scripts、壞掉的 templates，或 Google 無法 render 的內容，它無法直接修復。這類情況應先解決技術問題。
這和 schema plugins 有什麼不同？
Plugins 可以快速注入 schema，但常會使用通用預設值、遺漏企業特定的 entity details，或因 themes 與 extensions 造成重複 markup。當你需要 editorial judgment、自訂 JSON-LD、template strategy，或稽核 plugin 目前實際輸出的內容時，schema-markup skill 會更有幫助。
schema-markup 只適合技術 SEO 團隊嗎？
不是，但它最適合技術 SEO 工作流程，尤其是結構化資料必須準確、可測試、可部署的情境。內容團隊可以用它規劃 Article、FAQ 與 HowTo。開發者可以用它把已核准的 schema 轉成 templates。電商團隊則可以在 rollout 前檢查 Product、Offer、availability 與 review markup。
如何改進 schema-markup skill
提供更有力的來源證據
提升 schema-markup 結果的最佳方式，是提供 Google 也能驗證的同一批證據：rendered page copy、可見 headings、product details、author pages、images、dates、breadcrumbs 與 organization profiles。如果某個欄位頁面上不可見或無法驗證，請明確要求 agent 將其標示為 missing，而不是自行編造。
留意常見的 schema-markup 失敗模式
常見失敗包括使用相對路徑 image URLs、為頁面上不可見的問題加入 FAQ markup、把 marketing copy 標成 reviews、Product schema 缺少 offers、author names 不一致、date formats 無效，以及多個 plugins 產生重複 JSON-LD。另一個常見問題是過度標記：加入所有可能的 schema type，而不是只使用少數能準確代表頁面的類型。
第一版輸出後持續迭代
拿到第一版 JSON-LD draft 後，請要求進行驗證檢查：「Check required fields, recommended fields, visible-content alignment, Google rich result eligibility, and implementation risks。」接著執行 validator script 或 Google 的測試工具，並把精確錯誤訊息貼回給 agent。針對特定錯誤迭代，通常會比要求泛泛重寫得到更好的結果。
依照你的 CMS 與 templates 調整 skill
若要能重複採用，請把一個已驗證的頁面轉成 template-level implementation。請 skill 將 schema fields 對應到 CMS variables、指出欄位為空時的 fallback behavior，並定義 JSON-LD 應該注入的位置。這正是 schema-markup 比一次性 prompting 更有價值的地方：它能協助建立一套可控的結構化資料工作流程，讓 editors、SEOs 與 developers 都能維護。