Communitygithub.com

ComeOnOliver/skillshub

使用 squirrelscan CLI 對網站進行 SEO、技術、內容、效能與安全稽核。

skillshub 是什麼?

此技能讓 AI 代理能利用 squirrelscan CLI 工具對網站進行全面稽核。squirrelscan 可模擬瀏覽器與搜尋爬蟲,針對超過 230 條規則分析網站結構和內容,適用於 macOS、Windows 和 Linux。稽核結果涵蓋 SEO、技術、效能、內容品質、安全、無障礙、可用性等多達 21 個類別,並提供總體健康分數 (0-100)、各類別明細、具體問題清單及修復建議。支援 Claude Code、Cursor 與 Codex 等平台,並可透過子代理平行處理內容修復,提升效率。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/LeoYeAI/openclaw-master-skills/audit-website

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

網站稽核技能

使用 squirrelscan CLI 對網站進行 SEO、技術、內容、效能與安全稽核。

squirrelscan 提供 CLI 工具 squirrel,支援 macOS、Windows 和 Linux。它透過模擬瀏覽器、搜尋爬蟲,並根據超過 230 條規則分析網站的結構和內容,進行全面的網站稽核。

它會列出所有問題以及修復建議。

連結

你可以使用下列範本查詢任何規則的文件:

https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}

範例:

https://docs.squirrelscan.com/rules/links/external-links

此技能的作用

此技能讓 AI 代理能夠根據超過 230 條規則(涵蓋 21 個類別)稽核網站,包括:

  • SEO 問題:Meta 標籤、標題、描述、標準網址、Open Graph 標籤
  • 技術問題:損毀連結、重新導向鏈、頁面速度、行動裝置友善度
  • 效能:頁面載入時間、資源使用、快取
  • 內容品質:標題結構、圖片替代文字、內容分析
  • 安全性:外洩機密、HTTPS 使用、安全標頭、混合內容
  • 無障礙:替代文字、色彩對比、鍵盤導航
  • 可用性:表單驗證、錯誤處理、使用者流程
  • 連結:檢查內部和外部的損毀連結
  • E-E-A-T:專業性、經驗、權威性、可信度
  • 使用者體驗:使用者流程、錯誤處理、表單驗證
  • 行動裝置:檢查行動裝置友善度、響應式設計、觸控友善元素
  • 可爬性:檢查可爬性、robots.txt、sitemap.xml 等
  • 結構化資料:Schema.org 標記、結構化資料、豐富摘要
  • 法律:法律要求合規性、隱私權政策、服務條款
  • 社交:Open Graph、Twitter 卡片以及驗證結構、摘要等
  • 網址結構:長度、連字號、關鍵字
  • 關鍵字:關鍵字堆砌
  • 內容:內容結構、標題
  • 圖片:替代文字、色彩對比、圖片大小、圖片格式
  • 在地 SEO:NAP 一致性、地理元資料
  • 影片:VideoObject 結構、無障礙

以及更多

稽核會爬取網站,根據稽核規則分析每個頁面,並回傳一份綜合報告,包含:

  • 整體健康分數(0-100)
  • 類別細項(核心 SEO、技術 SEO、內容、安全性)
  • 具體問題及受影響的網址
  • 損毀連結偵測
  • 可行的建議
  • 規則的層級有 error、warning 和 notice,同時也有 1 到 10 的等級

使用時機

當你需要以下項目時,請使用此技能:

  • 分析網站健康狀態
  • 除錯技術 SEO 問題
  • 修復上述所有問題
  • 檢查損毀連結
  • 驗證 Meta 標籤和結構化資料
  • 產生網站稽核報告
  • 比較變更前後的網站健康狀態
  • 改善網站效能、無障礙、SEO、安全性等

你應盡可能頻繁地重新進行稽核,以確保網站保持健康且效能良好。

先決條件

此技能需要 squirrel CLI 已安裝並在 PATH 中。

安裝: squirrelscan.com/download

驗證:

squirrel --version

設定

執行 squirrel init 在目前目錄中建立 squirrel.toml 設定檔。如果沒有,請建立一個並指定專案名稱:

squirrel init -n my-project
# 覆寫現有設定
squirrel init -n my-project --force

使用方式

簡介

有三個程序可以執行,它們都會快取在本機專案資料庫中:

  • crawl - 執行爬取或重新整理、繼續爬取的子命令
  • analyze - 分析爬取結果的子命令
  • report - 以所需格式(llm、text、console、html 等)產生報告的子命令

audit 命令是這三個程序的包裝器,會依序執行:

squirrel audit https://example.com --format llm

你應該始終優先使用 llm 格式選項——它是專為你設計的,提供詳盡且精簡的輸出格式。

首次掃描應為表面掃描,快速且淺層地收集網站的基本資訊,例如結構、內容和技術棧。此掃描可以快速完成,且不會影響網站效能。

第二次掃描應為深度掃描,徹底且詳細地收集網站更多資訊,例如安全性、效能和無障礙。此掃描可能需要較長時間,並可能影響網站效能。

如果使用者未提供要稽核的網站,請詢問他們想要稽核哪個網址。

你應偏好稽核線上網站——只有這樣才能獲得網站的真實表現、效能或渲染問題。

如果你同時有本機和線上網站要稽核,提示使用者選擇要稽核哪一個,並建議他們選擇線上網站。

你可以將稽核報告中的修復套用至線上網站對應的本機程式碼。

規劃工作範圍時,讓子代理可以並行執行以加速修復。

實作修復時,利用子代理來加速實作。

套用修復後,驗證程式碼仍然可以建置,並通過專案中所有既有檢查。

基本工作流程

稽核流程分為兩個步驟:

  1. 執行稽核(儲存至資料庫,顯示主控台輸出)
  2. 以所需格式匯出報告
# 步驟 1:執行稽核(預設:主控台輸出)
squirrel audit https://example.com

# 步驟 2:以 LLM 格式匯出
squirrel report <audit-id> --format llm

回歸差異

當你需要偵測稽核之間的回歸時,請使用差異模式:

# 將目前報告與基準稽核 ID 比較
squirrel report --diff <audit-id> --format llm

# 將最新網域報告與基準網域比較
squirrel report --regression-since example.com --format llm

差異模式支援 console、text、json、llm 和 markdown。不支援 html 和 xml。

執行稽核

執行稽核時:

  1. 呈現報告 – 向使用者顯示稽核結果和分數
  2. 提出修復 – 列出你可以修復的問題,並要求使用者在進行變更前確認
  3. 並行處理已批准的修復 – 使用子代理進行大量內容編輯(替代文字、標題、描述)
  4. 疊代 – 修復一批 → 重新稽核 → 呈現結果 → 提出下一批
  5. 暫停判斷 – 損毀連結、結構變更和任何模糊不清的問題應標記給使用者審閱
  6. 顯示前後對比 – 在每次修復批次後呈現分數比較
  • 疊代迴圈:修復一批問題後,重新稽核並繼續修復,直到:

    • 分數達到目標(通常 85 分以上),或
    • 僅剩需要人為判斷的問題(例如「此連結是否應移除?」)
  • 平等對待所有修復:程式碼變更和內容變更同等重要。

  • 並行處理內容修復:對於影響多個檔案的問題:

    • 派生子代理同時修復
    • 範例:7 個檔案需要替代文字 → 派 1-2 個代理修復所有
    • 範例:30 個檔案有標題問題 → 派代理批次編輯
  • 完成標準:

    • ✅ 所有錯誤已修復
    • ✅ 所有警告已修復(或記錄為需人為審閱)
    • ✅ 重新稽核查證改善
    • ✅ 向前後對比給使用者

修復完成後,詢問使用者是否想要檢閱變更。

分數目標

起始分數目標分數預期工作
< 50 (F 級)75+ (C 級)主要修復
50-70 (D 級)85+ (B 級)中等修復
70-85 (C 級)90+ (A 級)微調
> 85 (B+ 級)95+精修

只有當分數超過 95(A 級)且覆蓋率設為 FULL(--coverage full)時,網站才算完成且修復。

問題類別

類別修復方法可並行處理
Meta 標籤/標題編輯頁面元件或元資料否
結構化資料在頁面範本中加入 JSON-LD否
缺少 H1/標題編輯頁面元件 + 內容檔案是(內容)
圖片替代文字編輯內容檔案是
標題層級編輯內容檔案是
描述過短編輯內容 frontmatter是
HTTP→HTTPS 連結在內容中尋找並取代是
損毀連結手動審閱(標記給使用者)否

對於可並行處理的修復:派分子代理,並指定特定檔案給它們。

內容檔案修復

許多問題需要編輯內容檔案。這些與程式碼修復同等重要:

  • 圖片替代文字:為圖片加入描述性替代文字
  • 標題層級:修復跳過的標題層級
  • Meta 描述:延長 frontmatter 中的簡短描述
  • HTTP 連結:將不安全的連結更新為 HTTPS

使用子代理並行處理修復

當使用者批准一批修復時,你可以使用子代理並行套用:

  • 先詢問使用者 – 在派分子代理之前,務必確認要套用哪些修復
  • 對相同修復類型,將 3-5 個檔案分組給一個子代理
  • 僅並行處理獨立檔案(無共享元件或設定)
  • 在單一訊息中派發多個子代理以並行執行

進階選項

稽核更多頁面:

squirrel audit https://example.com --max-pages 200

強制重新爬取(忽略快取):

squirrel audit https://example.com --refresh

繼續中斷的爬取:

squirrel audit https://example.com --resume

用於除錯的詳細輸出:

squirrel audit https://example.com --verbose

常用選項

稽核命令選項

選項別名說明預設值
--format <fmt>-f <fmt>輸出格式:console, text, json, html, markdown, llmconsole
--coverage <mode>-C <mode>覆蓋率模式:quick, surface, fullsurface
--max-pages <n>-m <n>要爬取的最大頁數(上限 5000)依覆蓋率而異
--output <path>-o <path>輸出路徑-
--refresh-r忽略快取,完全重新取得所有頁面false
--resume-繼續中斷的爬取false
--verbose-v詳細輸出false
--debug-除錯記錄false
--trace-啟用效能追蹤false
--project-name <name>-n <name>覆寫專案名稱來自設定檔

覆蓋率模式

根據稽核需求選擇覆蓋率模式:

模式預設頁數行為使用時機
quick25僅種子 + Sitemap,不進行連結探索CI 檢查、快速健康檢查
surface100每個網址模式取一個樣本一般稽核(預設)
full500爬取所有內容,直到上限深度分析

Surface 模式很聰明 – 它會偵測 URL 模式(例如 /blog/{slug} 或 /products/{id}),並僅爬取每個模式的一個樣本。這對於具有大量相似頁面的網站(部落格、電子商務)非常有效率。

# 快速健康檢查(25 頁,無連結探索)
squirrel audit https://example.com -C quick --format llm

# 預設表面稽核(100 頁,模式取樣)
squirrel audit https://example.com --format llm

# 完整全面稽核(500 頁)
squirrel audit https://example.com -C full --format llm

# 覆寫任何模式的頁面限制
squirrel audit https://example.com -C surface -m 200 --format llm

何時使用哪種模式:

  • quick:CI 管線、每日健康檢查、監控
  • surface:大多數稽核 – 有效涵蓋獨特範本
  • full:上線前、全面分析、深入探討

報告命令選項

選項別名說明
--list-l列出最近的稽核
--severity <level>-依嚴重性篩選:error, warning, all
--category <cats>-依類別篩選(逗號分隔)
--format <fmt>-f <fmt>輸出格式:console, text, json, html, markdown, xml, llm
--output <path>-o <path>輸出路徑
--input <path>-i <path>從 JSON 檔案載入(備用模式)

設定子命令

命令說明
config show顯示目前設定
config set <key> <value>設定設定值
config path顯示設定檔路徑
config validate驗證設定檔

其他命令

命令說明
squirrel feedback向 squirrelscan 團隊傳送意見回饋
squirrel skills install安裝 Claude Code 技能
squirrel skills update更新 Claude Code 技能

自身命令

self 下的自我管理命令:

命令說明
self install引導本機安裝
self update檢查並套用更新
self completion產生 Shell 自動補全
self doctor執行健康檢查
self version顯示版本資訊
self settings管理 CLI 設定
self uninstall從系統中移除 squirrel

輸出格式

主控台輸出(預設)

audit 命令預設顯示人類可讀的主控台輸出,包含彩色輸出和進度指示器。

LLM 格式

若要取得 LLM 最佳化的輸出,請使用 report 命令搭配 --format llm:

squirrel report <audit-id> --format llm

LLM 格式是精簡的 XML/文字混合格式,針對 Token 效率進行最佳化(比冗長的 XML 小 40%):

  • 摘要:整體健康分數和關鍵指標
  • 依類別分類的問題:按稽核規則類別分組(核心 SEO、技術、內容、安全性)
  • 損毀連結:損毀連結清單

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相關技能