NenadZivotic/lite-agent-skills

로컬 HTML 파일의 오프라인 on-page SEO 감사 — 제목 및 메타 설명 품질, canonical, robots 메타, viewport, Open Graph 태그, h1 구조, 이미지 alt 적용 여부, lang/charset. 네트워크 연결 없음. 사용자가 저장된 HTML 또는 템플릿 파일에서 페이지의 SEO 기본 사항을 확인하도록 요청할 때 사용합니다.

lite-agent-skills란 무엇인가요?

이 스킬은 사용자가 제공한 로컬 HTML 파일에 대해 코어 on-page SEO 검사를 수행하는 오프라인 도구입니다. `scripts/audit.mjs` Node.js 스크립트를 실행하여 JSON 형식의 보고서를 생성하며, 네트워크에 전혀 접근하지 않습니다. title, meta-description, canonical, robots-meta, viewport, Open Graph, h1, img-alt, lang, charset 등 10개 항목에 대해 pass/warn/fail 상태를 반환하며, 각 검사에 대한 구체적인 수정 가이드라인을 제공합니다. Node 18+ 이상에서 제로 의존성으로 실행되며, 오류 감지 시 CI 게이트 역할을 할 수 있도록 종료 코드 1을 반환합니다. Cursor, Windsurf, Claude Code, Cline, Continue 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 로컬 파일 기반 작업에 특화되어 있어 보안 및 개인정보 보호에 유리합니다.

지원 대상~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/seo-quick-audit-lite

문서

SEO Quick Audit (Lite)

사용자가 제공한 로컬 HTML 파일에 대해 scripts/audit.mjs를 실행하고 핵심 on-page SEO 검사에 대한 pass/warn/fail을 보고합니다. 완전히 오프라인에서 작동합니다 — 스크립트는 하나의 파일을 읽고 JSON을 출력합니다.

범위 및 규칙

사용자가 제공한 파일만 감사합니다. 이 라이트 버전은 URL, robots.txt 또는 sitemap.xml을 가져오지 않습니다 — 보고 시 이 점을 명시하세요.
Pass/fail은 일반적인 관례에 기반하며, 검색 엔진의 보장이 아닙니다.
파일을 절대 수정하지 마세요. 읽기 전용입니다.

1. 실행

Node 18+ 필요, 제로 의존성.

node <skill-dir>/scripts/audit.mjs page.html

stdout에 JSON 출력; warn/fail이 하나라도 있으면 종료 코드 1 (CI 게이트 가능), 읽기/사용 오류 시 2.

2. 보고서 읽기

summary: pass/warn/fail/info 개수.
checks[]: {id, status, detail} 포함 대상: title, meta-description, canonical, robots-meta, viewport, open-graph, h1, img-alt, lang, charset.

3. 수정 가이드

title/meta-description warn → 각각 약 30-65자 / 50-160자로 다시 작성.
robots-meta: noindex가 순위를 목표로 하는 페이지에 있음 → 지시문 제거.
canonical 누락 → <link rel="canonical"> 추가.
h1 fail → 페이지당 정확히 하나의 설명적인 h1.
open-graph warn → 링크 미리보기를 위해 og:title/og:description/og:image 추가.

Lite vs Full

전체 seo-quick-audit 버전은 추가로 라이브 URL을 가져와 /robots.txt 및 /sitemap.xml 상태, twitter-card 검사, 리디렉션 처리를 수행합니다.