Claude SEO 스킬은 Markdown 파일 하나가 들어 있는 폴더입니다. 그 파일이 스킬이 무엇을 하는지, 언제 써야 하는지, 어떻게 실행하는지를 에이전트에게 알려 줍니다. Claude Code, Codex, 그리고 이 규약을 지원하는 다른 에이전트는 같은 형식을 읽습니다. 맨 위의 짧은 메타데이터 블록, 그다음에 지시 사항이 오는 구조입니다.
팀이라면 운영을 시작한 지 약 2주쯤 뒤에 반드시 부딪히는 질문이 있습니다. 이 중 무엇을 설치할 것인가입니다. 전부 설치하면 컨텍스트 윈도가 채워질까 걱정되고, 아무것도 설치하지 않으면 메모 앱에서 프롬프트를 복사해 오는 시절로 돌아갑니다.
우리는 이 질문에 답하려고 우리 라이브러리를 측정했고, 답은 깔끔하게 둘로 갈렸습니다. 스킬은 쓰이지 않고 놓여 있는 동안에는 비용이 거의 들지 않습니다. 실제로 발동할 때 진짜 컨텍스트를 씁니다. 우리 라이브러리의 중앙값은 대기 메타데이터 107 토큰, 지시 본문 1,851 토큰이었습니다. 이 두 숫자는 의사 결정에서 서로 다른 역할을 해야 합니다.
측정 방법
한 대의 머신에 있는 두 개의 스킬 루트에서 모든 SKILL.md 파일을 파싱하고, 각 파일을 frontmatter 경계에서 나눴습니다.
항목 | 값 |
|---|---|
파싱한 스킬 파일 | 76 |
중복을 제외한 스킬 이름 | 75 |
메타데이터 블록 합계 | 8,231 토큰(추정) |
지시 본문 합계 | 222,952 토큰(추정) |
본문 대 메타데이터 비율 | 27 대 1 |
토큰 수는 4자 = 1토큰으로 추정했습니다. 영어 기술 문서에서는 좋은 근사치지만 정확하지는 않습니다. 절대값이 아니라 비교용 숫자로 보세요. 발견은 비율과 분포에 있고, 절대값은 여러분의 파일에 따라 달라집니다.
선반 비용이 작게 유지되는 이유
스킬 시스템은 점진적 공개를 씁니다. 메타데이터 블록은 에이전트가 스킬의 존재와 적용 시점을 알 수 있도록 로드됩니다. 본문은 스킬이 호출될 때만 읽힙니다.
이 설계가 만드는 분포는 한 번 볼 만합니다.
백분위 | 스킬당 대기 비용 | 스킬당 본문 비용 |
|---|---|---|
최소 | 43 토큰 | 428 토큰 |
중앙값 | 107 토큰 | 1,851 토큰 |
90 백분위 | 161 토큰 | 7,125 토큰 |
최대 | 246 토큰 | 21,702 토큰 |
76개 파일 전체를 다 합쳐도 대기 메타데이터는 8,231 토큰입니다. 긴 글 한 편 정도 크기이고, 아무 일도 하기 전에 에이전트가 75개 스킬의 존재를 아는 데 치르는 값입니다. 라이브러리에서 가장 큰 메타데이터 블록은 246 토큰입니다.
흥미로운 쪽은 최대값입니다. 라이브러리에서 가장 말이 많은 스킬도 언제 써야 하는지 알리는 데 246 토큰밖에 쓰지 않습니다. 스킬을 선반에 늘어놓아도 세션이 가라앉지 않을 정도의 양입니다. SEO 스킬 다섯 개를 설치하면 데이터 자리를 빼앗기지 않을까 걱정된다면, 측정 결과는 혼잡이 일어나는 곳이 선반이 아니라고 말합니다.
비용이 실제로 사는 곳
진짜는 본문이고, 편차도 넓습니다. 75개 중 15개는 발동할 때 1,000 토큰 미만을 읽습니다. 11개는 5,000 토큰을 넘습니다. 가장 큰 것은 21,702를 읽습니다.
SEO 운영에서는 이 범위가 계획의 기준이 됩니다. 스킬이 하는 일의 양과 대응하기 때문입니다. 페이지 하나를 감사하는 스킬은 쌉니다. 사이트 전체를 크롤링하고, 기준선과 비교하고, 보고서를 쓰는 스킬은 단계가 많은 만큼 지시도 많습니다.
발동 비용은 낮은 쪽에 몰려 있다가 길게 늘어집니다. 5,000 토큰을 넘는 스킬이 11개입니다.
다음은 우리 검색·측정 세트를 같은 방식으로 측정한 결과입니다.
스킬 | 대기 | 발동 시 |
|---|---|---|
tool-cluster-builder | 70 토큰 | 428 토큰 |
seo-tools-local | 102 토큰 | 638 토큰 |
geo-operator | 101 토큰 | 665 토큰 |
dataforseo-toolkit | 238 토큰 | 849 토큰 |
ahrefs-2026-content-refresh | 51 토큰 | 958 토큰 |
search-engine-visibility-audit | 49 토큰 | 1,121 토큰 |
codex-link-equity-audit | 96 토큰 | 1,163 토큰 |
gsc | 116 토큰 | 1,309 토큰 |
bing-webmaster | 135 토큰 | 1,685 토큰 |
seo-beginner-automation | 98 토큰 | 1,836 토큰 |
열 개 전부 | 1,055 토큰 | 10,652 토큰 |
SEO 스킬 열 개는 선반에 두면 약 1,000 토큰, 전부 발동하면 약 10,000 토큰입니다.
이 표에서 두 가지가 나옵니다.
대기 열은 거의 평평합니다. SEO 스킬 열 개를 갖춰 두는 데 1,055 토큰. 검색 결과 한 페이지나 크롤 내보내기 옆에서는 반올림 오차이고, 감당할 수 있다고 생각하는 선반이 아니라 원하는 선반을 설치하라는 근거가 됩니다.
발동 열은 평평하지 않습니다. 세트는 428에서 1,836 토큰까지, 네 배 차이입니다. 실제로는 한 세션에서 두 개 넘게 발동하는 일이 드물기 때문에, 정직한 계획 숫자는 10,652가 아닙니다. 그 세션이 이미 들고 있는 데이터 위에 몇천 토큰이 더해지는 정도입니다.
스킬을 고를 때 이 숫자가 뜻하는 것
측정에서 따라 나오는 세 가지 선택 규칙입니다.
설명이 아니라 본문을 보세요. 메타데이터 블록은 스킬의 광고입니다. 설명이 50 토큰이고 본문이 7,000 토큰인 스킬이 가능합니다. 설치 전에 파일을 읽고 frontmatter 아래의 길이를 확인하세요. 빠른 필터가 필요하면 파일 크기와 줄 수가 스킬이 얼마나 끌어올지에 대한 괜찮은 대리 지표입니다.
데이터를 심는 스킬보다 데이터를 읽는 스킬을 선호하세요. API를 호출해 응답을 읽는 스킬은 키워드가 몇 개든 비용이 고정입니다. Markdown 안에 조회 표나 템플릿 모음을 품은 스킬은 그 표가 필요하든 아니든 같은 비용을 냅니다. 849 토큰짜리 DataForSEO 래퍼가 실제로는 보기보다 싼 이유이고, 템플릿 기반의 큰 콘텐츠 스킬이 설명보다 비싼 이유입니다.
선반이 아니라 세션에 예산을 배정하세요. 중요한 숫자는 활동 중인 세션의 총 토큰이고, 스킬은 그 입력 중 하나일 뿐입니다. 크롤 내보내기를 붙여 넣고 스킬 세 개를 로드한 세션은 컨텍스트 문제입니다. 스킬 스무 개를 갖춰 두고 하나만 로드한 세션은 문제가 아닙니다.
스킬이 정답인 경우와 그렇지 않은 경우
스킬과 MCP 서버는 같은 문제의 서로 다른 절반을 풉니다. 맞지 않는 쪽을 쓰면 결국 둘 다 못 갖게 되는 이유가 여기 있습니다.
스킬은 지시이고 아무것도 모릅니다. 순위 하락을 어떻게 분류할지, 감사 출력을 어떻게 구성할지, 링크 프로필 검토에 어떤 증거가 필요한지처럼 반복되는 판단에 맞는 형태입니다. 비용은 컨텍스트이고, 세션마다 지불합니다.
MCP 서버는 살아 있는 연결입니다. 에이전트가 다른 방법으로는 닿을 수 없는 데이터, 예컨대 Search Console이나 백링크 인덱스에 맞는 형태입니다. 비용은 설정, 자격 증명, 권한이고, 한 번만 지불합니다. 이런 연결이 실제로 무엇을 노출하는지 알고 싶다면 SEO MCP 서버 네 종 비교가 이 검증 글에 있습니다.
잘 맞는 짝은 데이터 소스마다 연결 하나, 반복되는 판단마다 스킬 하나입니다. 우리 워크플로에서도 Search Console 연결은 서버이고, 일일 모니터링 루틴은 스킬입니다. 반복되는 쪽이 판단이기 때문입니다.
설치 전에 확인할 것
짧은 검증 절차입니다. 이 형식은 쓰기 쉽고, 잘못 쓰기도 쉽기 때문입니다.
- frontmatter를 읽고 설명이 구체적인 트리거를 지목하는지 확인하세요. "SEO에 도움이 됩니다"라는 설명은 엉뚱한 순간에 로드됩니다.
- frontmatter 아래의 줄 수를 세세요. 100줄 미만이면 집중된 스킬입니다. 500줄을 넘으면 그 세부 내용이 스킬이 필요할 때 읽는 별도 파일이어야 할 참조 자료인지 확인하세요.
- 파일에서 자격 증명과 하드코딩된 경로를 찾으세요. 스킬은 설정을 환경에서 읽어야 하고, 토큰을 품고 있어서는 안 됩니다.
- 사이트에 쓰는지 확인하세요. 읽기만 하는 스킬은 실제 속성에서 시험해도 안전합니다. 파일을 편집하는 스킬에는 무엇이 바뀌기 전의 검토 단계가 있어야 합니다.
- 신경 쓰지 않는 속성에서 한 번 실행하고 출력을 읽으세요. 대부분의 스킬은 지시가 아니라 출력 형식으로 평가됩니다.
자주 묻는 질문
설치한 스킬이 모든 세션을 느리게 만드나요? 메타데이터 블록만큼만 느려집니다. 우리 라이브러리에서는 중앙값이 107 토큰이고 76개 파일 합계가 8,231 토큰입니다. 지시는 스킬을 쓸 때 로드되고, 그 전에는 아닙니다.
SEO 스킬은 몇 개나 설치해 두어야 하나요? 우리 세트에서는 검색·측정 스킬 열 개가 대기 메타데이터 약 1,000 토큰입니다. 한계가 컨텍스트인 경우는 드뭅니다. 진짜 한계는 각각이 무엇을 위한 것인지 기억할 수 있는 여러분 자신의 능력입니다.
스킬 파일이 크면 나쁜 신호인가요? 자동으로 그렇지는 않습니다. 참조 자료가 많은 스킬은 정당하게 깁니다. 다만 길이는 스킬이 하는 일로 정당화되어야 합니다. 500줄짜리 스킬이 설명만 잔뜩 붙여 API를 한 번 호출한다면, 그것은 역량이 아니라 문서화 문제입니다.
직접 Claude SEO 스킬을 쓸 수 있나요? 그럴 수 있고, 반복되는 루틴이 하나라도 있다면 수익률이 가장 높은 선택입니다. 먼저 그 작업을 손으로 두 번 실행하고, 변하지 않은 단계를 적어 본문에 넣으세요. frontmatter는 150 토큰 아래로 유지하고 트리거를 정확히 서술하세요.
이 숫자는 Claude Code에만 해당하나요? 형식과 점진적 공개 모델은 SKILL.md를 지원하는 에이전트 사이에서 공유됩니다. Claude Code와 Codex 모두 마찬가지입니다. 측정은 우리 라이브러리에서 나온 것이므로 여러분의 분포는 파일 크기에 따라 달라질 것입니다.
Auspia 관점: 원하는 선반을 설치하고, 그다음 무엇이 발동하는지 감사하세요. 스킬 라이브러리의 대기 비용은 걱정을 그만둘 만큼 작습니다. 잘못 쓴 스킬이 실제로 아픈 곳은 발동 비용입니다. 자기 세트를 측정해 본 적이 없다면, 각 파일의 frontmatter 아래 줄을 세는 데 약 10분이 걸리고 무게가 어디에 있는지 알려 줍니다. GEO 작업에서 스킬과 서버를 나누는 자세한 기준은 GEO 스킬 노트에서 다룹니다.
글: Alice Monroe, Auspia에서 150개 이상의 도구를 다루는 AI SEO 도구 분석가. AI SEO 도구, 스킬과 서버 아키텍처, 에이전트 스택의 각 계층이 실제로 드는 비용을 씁니다.
