Communitygithub.com

ComeOnOliver/skillshub

squirrelscan CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 성능 및 보안 문제를 감사합니다.

skillshub란 무엇인가요?

이 스킬은 AI 에이전트가 squirrelscan CLI 도구를 활용하여 웹사이트에 대한 포괄적인 감사를 수행할 수 있도록 합니다. 230개 이상의 규칙을 21개 카테고리(SEO, 기술 문제, 성능, 콘텐츠 품질, 보안, 접근성 등)에 걸쳐 적용하여 웹사이트의 전반적인 상태를 평가합니다. 감사 결과는 0-100점 사이의 종합 건강 점수와 함께 각 문제의 심각도(오류, 경고, 알림) 및 순위(1-10)를 제공하며, 구체적인 문제점과 수정 제안을 포함합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, squirrel CLI가 설치되어 PATH에 등록되어 있어야 합니다. 사용자는 표면 스캔(빠른 기본 정보 수집)과 심층 스캔(상세 분석)을 선택할 수 있으며, 감사 결과를 기반으로 수정 작업을 수행한 후 재감사를 통해 개선 사항을 확인하는 반복적인 워크플로우를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/LeoYeAI/openclaw-master-skills/audit-website

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

웹사이트 감사 스킬

squirrelscan CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 성능 및 보안 문제를 감사합니다.

squirrelscan은 macOS, Windows, Linux에서 사용 가능한 CLI 도구 squirrel을 제공합니다. 이 도구는 브라우저와 검색 크롤러를 에뮬레이션하고, 230개 이상의 규칙에 따라 웹사이트 구조와 콘텐츠를 분석하여 광범위한 웹사이트 감사를 수행합니다.

감사 결과는 문제 목록과 함께 문제 해결 방법에 대한 제안을 제공합니다.

링크

다음 템플릿을 사용하여 규칙에 대한 문서를 조회할 수 있습니다:

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

예시:

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

이 스킬이 하는 일

이 스킬은 AI 에이전트가 21개 카테고리의 230개 이상의 규칙으로 웹사이트를 감사할 수 있게 합니다. 여기에는 다음이 포함됩니다:

  • SEO 문제: 메타 태그, 제목, 설명, 표준 URL, 오픈 그래프 태그
  • 기술 문제: 끊어진 링크, 리디렉션 체인, 페이지 속도, 모바일 친화성
  • 성능: 페이지 로드 시간, 리소스 사용량, 캐싱
  • 콘텐츠 품질: 제목 구조, 이미지 대체 텍스트, 콘텐츠 분석
  • 보안: 유출된 비밀, HTTPS 사용, 보안 헤더, 혼합 콘텐츠
  • 접근성: 대체 텍스트, 색상 대비, 키보드 탐색
  • 사용성: 양식 검증, 오류 처리, 사용자 흐름
  • 링크: 내부 및 외부 링크의 끊어짐 확인
  • E-E-A-T: 전문성, 경험, 권위, 신뢰성
  • 사용자 경험: 사용자 흐름, 오류 처리, 양식 검증
  • 모바일: 모바일 친화성, 반응형 디자인, 터치 친화적 요소 확인
  • 크롤링 가능성: 크롤링 가능성, robots.txt, sitemap.xml 등 확인
  • 스키마: Schema.org 마크업, 구조화된 데이터, 리치 스니펫
  • 법률: 법적 요구 사항 준수, 개인정보 처리방침, 이용약관
  • 소셜: 오픈 그래프, 트위터 카드 및 스키마, 스니펫 등 검증
  • URL 구조: 길이, 하이픈, 키워드
  • 키워드: 키워드 채우기
  • 콘텐츠: 콘텐츠 구조, 제목
  • 이미지: 대체 텍스트, 색상 대비, 이미지 크기, 이미지 형식
  • 지역 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

가능하면 항상 llm 형식을 선호하세요. 이 형식은 AI를 위해 만들어졌으며, 간결하고 포괄적인 출력 형식을 제공합니다.

첫 번째 스캔은 표면 스캔이어야 합니다. 이는 웹사이트의 구조, 콘텐츠, 기술 스택과 같은 기본 정보를 빠르고 얕게 수집하는 스캔입니다. 이 스캔은 빠르게 수행할 수 있으며 웹사이트 성능에 영향을 미치지 않습니다.

두 번째 스캔은 심층 스캔이어야 합니다. 이는 보안, 성능, 접근성 등 웹사이트에 대한 더 많은 정보를 수집하기 위한 철저하고 상세한 스캔입니다. 이 스캔은 시간이 더 걸릴 수 있으며 웹사이트 성능에 영향을 미칠 수 있습니다.

사용자가 감사할 웹사이트를 제공하지 않은 경우, 어떤 URL을 감사할지 물어보세요.

실제 웹사이트를 감사하는 것을 선호하세요. 실제 환경에서만 웹사이트의 진정한 상태와 성능 또는 렌더링 문제를 파악할 수 있습니다.

로컬 및 라이브 웹사이트를 모두 감사할 수 있는 경우, 사용자에게 둘 중 하나를 선택하도록 요청하고 라이브를 선택하도록 제안하세요.

감사 결과를 활용하여 라이브 사이트의 문제를 로컬 코드에 적용할 수 있습니다.

범위가 지정된 작업을 계획할 때는 하위 에이전트가 동시에 실행될 수 있도록 하여 수정 속도를 높이세요.

수정 사항을 구현할 때는 하위 에이전트를 활용하여 구현 속도를 높이세요.

수정 사항을 적용한 후에는 코드가 여전히 빌드되고 프로젝트의 기존 검사를 통과하는지 확인하세요.

기본 워크플로우

감사 프로세스는 두 단계로 이루어집니다:

  1. 감사 실행 (데이터베이스에 저장, 콘솔 출력 표시)
  2. 원하는 형식으로 보고서 내보내기
# 1단계: 감사 실행 (기본값: 콘솔 출력)
squirrel audit https://example.com

# 2단계: LLM 형식으로 내보내기
squirrel report <audit-id> --format llm

회귀 차이(Diff)

감사 간의 회귀를 감지해야 할 때는 diff 모드를 사용하세요:

# 현재 보고서를 기준 감사 ID와 비교
squirrel report --diff <audit-id> --format llm

# 최신 도메인 보고서를 기준 도메인과 비교
squirrel report --regression-since example.com --format llm

diff 모드는 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)로 설정된 경우에만 사이트가 완전히 수정된 것으로 간주합니다.

문제 카테고리

카테고리수정 방법병렬화 가능
메타 태그/제목페이지 컴포넌트 또는 메타데이터 편집아니요
구조화된 데이터페이지 템플릿에 JSON-LD 추가아니요
H1/제목 누락페이지 컴포넌트 + 콘텐츠 파일 편집예 (콘텐츠)
이미지 대체 텍스트콘텐츠 파일 편집예
제목 계층 구조콘텐츠 파일 편집예
짧은 설명콘텐츠 프론트매터 편집예
HTTP→HTTPS 링크콘텐츠에서 찾아 바꾸기예
끊어진 링크수동 검토 (사용자에게 표시)아니요

병렬화 가능한 수정 사항의 경우: 특정 파일 할당과 함께 하위 에이전트를 생성합니다.

콘텐츠 파일 수정

많은 문제는 콘텐츠 파일을 편집해야 합니다. 이러한 작업은 코드 수정과 동등하게 중요합니다:

  • 이미지 대체 텍스트: 이미지에 설명적인 대체 텍스트 추가
  • 제목 계층 구조: 건너뛴 제목 수준 수정
  • 메타 설명: 프론트매터의 짧은 설명 확장
  • 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 검사, 빠른 상태 확인
surface100URL 패턴당 하나의 샘플일반 감사 (기본값)
full500제한까지 모든 항목 크롤링심층 분석

Surface 모드는 스마트합니다 - /blog/{slug} 또는 /products/{id}와 같은 URL 패턴을 감지하고 패턴당 하나의 샘플만 크롤링합니다. 이는 유사한 페이지가 많은 사이트(블로그, 전자상거래)에 효율적입니다.

# 빠른 상태 확인 (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 feedbacksquirrelscan 팀에 피드백 보내기
squirrel skills installClaude Code 스킬 설치
squirrel skills updateClaude Code 스킬 업데이트

자체 명령어

squirrel self 아래의 자체 관리 명령어:

명령어설명
self install로컬 설치 부트스트랩
self update업데이트 확인 및 적용
self completion셸 완성 스크립트 생성
self doctor상태 확인 실행
self version버전 정보 표시
self settingsCLI 설정 관리
self uninstall시스템에서 squirrel 제거

출력 형식

콘솔 출력 (기본값)

audit 명령어는 기본적으로 사람이 읽을 수 있는 콘솔 출력을 색상 및 진행 표시기와 함께 표시합니다.

LLM 형식

LLM에 최적화된 출력을 얻으려면 report 명령어와 함께 --format llm을 사용하세요:

squirrel report <audit-id> --format llm

LLM 형식은 토큰 효율성에 최적화된 간결한 XML/텍스트 하이브리드입니다(자세한 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

관련 스킬