seo-audit

seo-audit skill 概覽

seo-audit skill 的功能是什麼

seo-audit skill 會協助代理以結構化流程進行 SEO 審核，而不是一開始就丟出一堆泛泛建議。它的設計目的是診斷網站為什麼在自然搜尋表現不佳、應該先檢查哪些項目，以及如何把發現整理成有優先順序的行動計畫。

哪些人適合安裝這個 seo-audit skill

最適合：

• 想要建立可重複 SEO 診斷流程的行銷人員與創辦人
• 正在稽核 SaaS、內容型網站或企業網站的代理
• 正在處理流量下滑、索引問題、排名疲弱，或頁面 SEO 問題不明確的團隊
• 想要比一次性提示詞更完整的 seo-audit guide 的使用者

較不適合：

• 只想看 schema implementation 細節的使用者
• 正在做 programmatic SEO 頁面生成的使用者
• 重點放在 AI 搜尋優化，而非傳統搜尋審核的使用者

這個 skill 真正要解決的工作

多數人要求做 SEO audit，想要的不只是 checklist。他們真正想知道的是：

• 到底是什麼因素最可能卡住排名
• 一開始應該先蒐集哪些證據
• 在缺乏足夠存取權限時，哪些結論不該隨便下
• 現在最值得優先處理的是哪些問題

這個 skill 的價值，在於它強制採用有順序的審核流程：先看 crawlability 和 indexation，再看 technical foundations、on-page optimization、content quality，最後才是 authority 或 links。這樣的排序可以避免低價值建議擠掉更嚴重的網站健康問題。

這個 skill 和一般提示詞有什麼不同

它和一般 prompt 的實務差異在於：

• 如果有本地情境檔案，會先要求代理檢查產品行銷脈絡
• 在盲目開始 audit 前，會先補問缺少的商業與網站背景
• 對 findings 有明確的優先順序
• 明白提醒：如果只依賴抓取到的 HTML，schema markup 的判斷有侷限
• 預期輸出要包含 executive summary 與 prioritized actions 的報告結構

這些細節很重要，因為很多品質不佳的 SEO audit 看起來很有把握，卻跳過索引基本功，或在存取有限的情況下誇大自己能驗證的內容。

如何使用 seo-audit skill

seo-audit install 情境

可從 repo 安裝：

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

這會從 coreyhaines31/marketingskills repository 裡的 skills/seo-audit 加入這個 skill。skill 本身沒有另外的 installer，所以實際上的 seo-audit install 步驟，就是使用上面這個標準 Skills 指令。

第一次使用前先讀這些檔案

如果你想用最短時間掌握 repo 裡最有訊號的內容，建議依序打開：

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

為什麼這樣排：

• SKILL.md 會交代 audit workflow 與範圍
• evals/evals.json 能看出什麼才算好的執行結果
• 那份 writing reference 有助於讓 audit 輸出更易讀、少一點機器感；如果你要把 findings 分享給客戶或利害關係人，這點很重要

這個 skill 需要哪些輸入

seo-audit usage 的品質，高度取決於你提供的輸入。至少要給：

• 網站 URL
• 網站類型：SaaS、e-commerce、publisher、local business、marketplace 等
• SEO 目標：更多 leads、更多非品牌自然流量、流量下滑後的恢復、重點頁面排名提升
• 目標關鍵字或 topic clusters
• 已知問題：migration、redesign、CMS 變更、流量流失、索引申訴
• 範圍：全站、某個 section、某種 template，或單一頁面
• 存取層級：只能看公開網站、可用 Search Console data、analytics、crawl exports、competitor URLs

如果這些沒提供，skill 還是能用，但輸出會更偏向看得到的 on-page 檢查，以及較廣泛的 technical heuristics。

提問前先檢查本地情境

這個 seo-audit skill 最實用、卻也最容易被忽略的一點，就是它會指示你：如果存在 .agents/product-marketing-context.md 或 .claude/product-marketing-context.md，要先讀。若你是在專案 repo 內使用這個 skill，這一步通常能省掉許多關於受眾、定位與優先頁面的基本來回確認。

這會直接提升 audit 品質，因為 SEO 建議若能連到實際產品、轉換漏斗與市場脈絡，效果會好很多。

把模糊需求改寫成高品質的 audit prompt

弱的輸入：

• "Do an SEO audit of our site"

更強的輸入：

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

為什麼這樣有效：

• 它提供了商業背景
• 它定義了成功目標
• 它縮小了範圍
• 它鼓勵基於證據的不確定性，而不是假裝很確定

依照預期的審核順序執行

常見錯誤是從 copy 調整開始。這個 skill 在照它原本設計的順序使用時，價值會高得多：

1. Crawlability 和 indexation
2. Technical foundations
3. On-page optimization
4. Content quality
5. Authority 和 links

這個順序會直接影響結果。如果頁面被擋住、canonical 設錯，或內部連結結構薄弱，重寫 meta descriptions 並不能解決核心問題。

實務上這個 skill 應該檢查什麼

根據 repository 裡的訊號與 eval expectations，好的 seo-audit usage 應該包含這類檢查：

• robots.txt
• XML sitemap 是否存在以及品質如何
• indexation 與 crawl 訊號
• 網站架構與 internal linking 邏輯
• title tags 與 meta descriptions
• heading structure
• content relevance 與 optimization
• 可能影響 discoverability 或 performance 的 technical issues

接著，它應該把 findings 整理成可用來做決策的報告，而不是平鋪直敘的一串觀察。

注意 schema 偵測的限制

這不是小提醒，而是實際採用時很重要的細節。這個 skill 明確警告：不要只因為基本 page fetch 看不到，就下結論說「沒有 schema markup」。很多網站會在 client-side 注入 schema，或用簡單 fetch 抓不到的方式輸出。

好的輸出應該會這樣寫：

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

這讓 seo-audit skill 比那些過度自信的 audit 更值得信任。

使用預期的報告結構

為了讓交付內容更容易接手與落地，建議這個 skill 產出：

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

這很重要，因為利害關係人很少會根據原始筆記採取行動；他們通常是根據有排序、有理由、有影響說明與後續步驟的問題清單來決策。

用 evals 判斷輸出品質

skills/seo-audit/evals/evals.json 是判斷這個 skill 值不值得信任、值不值得持續使用的最佳檔案之一。它會呈現預期行為：

• 在背景不足時先問澄清問題
• 先處理 crawlability，再處理內容潤飾
• 檢查 robots 與 sitemap 的基本項目
• 避免對 schema 做無根據的斷言
• 以可用的結構呈現 findings

如果你的代理沒有做到這些，那它其實沒有好好遵循這個 skill。

seo-audit skill 常見問題

這個 seo-audit skill 適合新手嗎

適合，尤其是需要一套合理 audit 順序的新手。它能避免隨機式的 SEO 檢查，也能提供更清楚的起手框架。不過新手仍然需要提供商業背景，因為這個 skill 不能取代你對哪些頁面、哪些查詢真正重要的判斷。

這和直接叫 AI 做 SEO audit 有什麼不同

一般 prompt 也許能產出一份看似合理的 SEO 建議清單。但如果你要的是以下這些，這個 skill 會更好：

• 明確定義的 audit 順序
• 更好的範圍界定問題
• 更少沒有根據的結論
• 更容易拿去用的最終報告

它最大的實務優勢不是「功能比較多」，而是猜測更少、優先順序更清楚。

我可以用 seo-audit 來做 SEO Content 工作嗎

可以，但要有正確期待。這個 skill 可以支援 seo-audit for SEO Content，透過檢查 on-page optimization、content quality 與可能的 relevance 問題來協助你判斷。不過它的核心定位不是內容 brief 產生器。更適合把它拿來先診斷現有頁面是否符合搜尋意圖、metadata、headings 與網站結構，再決定哪些內容要重寫或新增。

一定要有 Search Console 或 analytics 存取權嗎

不一定。只靠公開網站檢查也能使用它，但品質上限會比較低。沒有 Search Console、analytics 或 crawl exports 時，這個 skill 能指出「可能」的問題，卻無法完整驗證每一項效能或索引相關主張。

什麼情況下不該用這個 skill

如果你的主要需求是以下任一項，就不建議使用這個 skill：

• 只做 schema markup 的新增或除錯
• 為了關鍵字覆蓋做大規模頁面生成
• 重點在 AI 搜尋曝光策略，而不是傳統 SEO 診斷

另外，如果使用者想在還沒理解底層問題前，就直接要求立即實作修正，這個 skill 的適配度也不高。

那份 writing reference 真的有關嗎

有，尤其當 audit 輸出會對客戶展示，或在公司內部流通時更有用。references/ai-writing-detection.md 不是 SEO framework 檔案，但確實能提升交付品質。寫得更乾淨、較不帶明顯機器感的建議，團隊通常更容易信任，也更容易採納。

如何改善 seo-audit skill 的使用效果

提供更完整的商業背景給 seo-audit skill

想最快提升 seo-audit skill 的效果，做法就是不要把它當成通用掃描器。請明確告訴它：

• 受眾是誰
• 哪些頁面最重要
• 哪個 conversion event 最重要
• 最近改了什麼
• 你在乎哪些 queries

這樣 audit 就會從「SEO observations」升級成「SEO decisions」。

網站很大時先縮小範圍

面對大型網站，不要直接要求模糊的 full audit，改成以下這類範圍會更好：

• homepage 加前 5 個 revenue pages
• 某一個目錄或 blog section
• 某一種 template type
• 某一群 traffic-loss pages

範圍越小，finding 通常越精準，建議也越能落地。

要求附上證據與不確定性標記

如果你想避免空泛輸出，可以要求它提供：

• observed issue
• why it matters
• confidence level
• recommended fix
• expected impact
• what requires further validation

這對 technical 與 indexation 類主張特別有幫助，因為公開檢查往往無法涵蓋全部情況。

避免流於表面的建議

常見失敗模式是：第一版輸出過度聚焦在 titles、keywords，以及泛泛的「提升內容品質」建議。

改善方式是，在 prompt 裡要求：

• 先看 crawl 和 index blockers
• 看 page template patterns，而不只是逐頁挑小毛病
• 檢查通往 priority pages 的 internal linking paths
• 找出 business intent 與 ranking page types 之間的不匹配

這樣才能讓 seo-audit 聚焦在高槓桿問題，而不是停留在表面修飾。

提供強弱頁面的對照案例

如果你知道哪些頁面表現好、哪些不好，最好兩者都提供。這樣 skill 就能進一步比較：

• title format
• heading depth
• content structure
• internal links
• intent match
• conversion alignment

比起要求它冷啟動審核整個網域，這種對照式輸入通常能帶來更好的建議。

第一次 audit 後要再迭代

第一輪輸出通常應該是一份有優先順序的清單，而不是最終 roadmap。好的後續提示詞包括：

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

這是把 seo-audit usage 轉成可執行計畫的最好方式。

在存取有限時留意過度斷言

如果代理無法 crawl、render JavaScript，或檢查平台設定，就不要讓它講得像自己擁有完整可視性。這個 skill 在這點上本來就有正確方向，請保留這層謹慎。這能提升信任，也能減少 false positives。

把輸出當成分流與初步診斷層

這份 seo-audit guide 最適合扮演 specialist work 前的第一層診斷工具。你可以拿它來：

• 找出最可能的 blockers
• 排定後續調查路徑
• 準備給利害關係人的摘要
• 判斷下一步需要更深入的 technical SEO、content work，還是 implementation support

這比期待 skill 單獨取代完整 SEO 工具或即時網站存取，更符合它真正的強項。