Communitygithub.com

ComeOnOliver/skillshub

使用 squirrelscan CLI 对网站进行 SEO、技术、内容、性能和安全性审计。

skillshub 是什么?

该技能使 AI 代理能够利用 squirrelscan CLI 工具对网站进行全面审计。它模拟浏览器和搜索引擎爬虫,并根据 230 多条规则分析网站,涵盖 SEO(元标签、结构化数据)、技术问题(断链、重定向链)、性能(页面加载时间、资源使用)、内容质量(标题结构、图片 alt 文本)、安全性(泄露的密钥、HTTPS 使用)、可访问性以及更多方面。审计结果提供 0-100 的健康评分、按类别(核心 SEO、技术 SEO、内容、安全)细分的分数、具体问题的 URL 列表以及可操作的建议。该技能支持并行修复,并允许在修复后重新审计以验证改进,适用于 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 代理能够审核网站是否符合 21 个类别的 230 多条规则,包括:

  • SEO 问题:元标签、标题、描述、规范 URL、Open Graph 标签
  • 技术问题:断链、重定向链、页面速度、移动端友好性
  • 性能:页面加载时间、资源使用、缓存
  • 内容质量:标题结构、图片 alt 文本、内容分析
  • 安全性:泄露的密钥、HTTPS 使用、安全标头、混合内容
  • 可访问性:Alt 文本、颜色对比度、键盘导航
  • 可用性:表单验证、错误处理、用户流程
  • 链接:检查内部和外部断链
  • E-E-A-T:专业知识、经验、权威性、可信度
  • 用户体验:用户流程、错误处理、表单验证
  • 移动端:检查移动端友好性、响应式设计、触摸友好元素
  • 可爬行性:检查可爬行性、robots.txt、sitemap.xml 等
  • Schema:Schema.org 标记、结构化数据、丰富摘要
  • 法律:符合法律要求、隐私政策、服务条款
  • 社交:Open Graph、Twitter 卡片以及验证架构、摘要等。
  • URL 结构:长度、连字符、关键词
  • 关键词:关键词堆砌
  • 内容:内容结构、标题
  • 图片:Alt 文本、颜色对比度、图片大小、图片格式
  • 本地 SEO:NAP 一致性、地理元数据
  • 视频:VideoObject 架构、可访问性

以及更多

审计会爬取网站,根据审计规则分析每个页面,并返回一份综合报告,内容包括:

  • 总体健康评分(0-100)
  • 类别细分(核心 SEO、技术 SEO、内容、安全性)
  • 带有受影响 URL 的具体问题
  • 断链检测
  • 可操作的建议
  • 规则分为错误、警告和通知级别,并具有 1 到 10 的等级

何时使用

在您需要以下情况时使用此技能:

  • 分析网站健康状况
  • 调试技术 SEO 问题
  • 修复上面提到的所有问题
  • 检查断链
  • 验证元标签和结构化数据
  • 生成站点审计报告
  • 比较更改前后的站点健康度
  • 改善网站性能、可访问性、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

您应始终首选 format 选项 llm - 它是专门为您设计的,提供详尽且紧凑的输出格式。

首次扫描 应为表面扫描,这是一种快速且浅层的网站扫描,用于收集网站的基本信息,如其结构、内容和技术栈。此扫描可以快速完成,不会影响网站性能。

第二次扫描 应为深度扫描,这是一种彻底且详细的网站扫描,用于收集网站的更多信息,如其安全性、性能和可访问性。此扫描可能需要更长时间,并可能影响网站性能。

如果用户未提供要审核的网站,请询问他们希望审核哪个 URL。

您应 首选 审核 实时网站 - 只有在那里我们才能获得网站、性能或渲染问题的真实表现。

如果您同时拥有要审核的本地和实时网站,请提示用户选择要审核的网站,并 建议 他们选择实时网站。

您可以将审计中的修复应用到实时网站,并同时应用到本地代码。

在规划任务范围时,请考虑让它们并发运行作为子代理,以加速修复。

在实施修复时,利用子代理来加快修复的实施速度。

应用修复后,验证代码仍然可以构建并通过项目中的任何现有检查。

基本工作流程

审计过程分为两步:

  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. 并行化已批准的修复 - 对批量内容编辑(alt 文本、标题、描述)使用子代理
  4. 迭代 - 修复一批 → 重新审计 → 呈现结果 → 提出下一批修复方案
  5. 暂停以进行判断 - 断链、结构性更改以及任何不明确的内容都应标记以供用户审查
  6. 显示前后对比 - 每次修复批次后呈现评分对比
  • 迭代循环:修复一批问题后,重新审计并继续修复,直到:

    • 分数达到目标(通常为 85+),或
    • 只剩下需要人类判断的问题(例如,“是否应删除此链接?”)
  • 同等对待所有修复:代码更改和内容更改同等重要。

  • 并行化内容修复:对于影响多个文件的问题:

    • 生成子代理以并行修复
    • 示例:7 个文件需要 alt 文本 → 生成 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)时,站点才算 完成并修复。

问题类别

类别修复方法可并行化
元标签/标题编辑页面组件或元数据否
结构化数据向页面模板添加 JSON-LD否
缺少 H1/标题编辑页面组件 + 内容文件是(内容)
图片 alt 文本编辑内容文件是
标题层级编辑内容文件是
简短描述编辑内容前部变量是
HTTP→HTTPS 链接在内容中查找并替换是
断链人工审查(标记给用户)否

对于可并行化的修复:使用特定的文件分配生成子代理。

内容文件修复

许多问题需要编辑内容文件。这些与代码修复同等重要:

  • 图片 alt 文本:为图片添加描述性 alt 文本
  • 标题层级:修复跳过的标题级别
  • 元描述:扩展前部变量中的简短描述
  • 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仅种子和站点地图,无链接发现CI 检查、快速健康检查
surface100每个 URL 模式一个样本一般审计(默认)
full500爬取所有内容,直到达到限制深入分析

表面模式很智能 - 它检测 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

相关技能