SDO: 스킬 디스커버리 최적화 — AI 에이전트 마켓플레이스의 SEO

Source: Dev.to

SEO는 Google을 위해 최적화합니다. ASO는 앱 스토어를 위해 최적화합니다. GEO는 ChatGPT 및 Perplexity와 같은 AI 챗봇을 위해 최적화합니다.

하지만 이제 AI 에이전트에게도 자체 마켓플레이스가 있습니다 — 예를 들어 ClawHub와 같이 에이전트에 새로운 능력을 부여할 스킬을 검색할 수 있는 곳입니다. 이러한 마켓플레이스는 자체 검색 알고리즘, 자체 순위 규칙, 그리고 검색에 노출되기 위한 자체 트릭을 가지고 있습니다.

SDO — Skill Discovery Optimization — 은(는) 이러한 스킬 마켓플레이스가 결과를 어떻게 순위 매기는지, 그리고 당신이 할 수 있는 방법을 이해하는 것입니다.

저는 ClawHub의 소스 코드를 파헤쳐서 그들의 검색이 정확히 어떻게 작동하는지 알아보았습니다. 제가 찾은 내용은 다음과 같습니다.

Source: …

ClawHub 검색이 실제로 작동하는 방식

쿼리를 ClawHub에 입력했을 때 어떤 일이 일어나는지 단계별로 살펴보겠습니다. 저는 소스 코드를 직접 읽어보는 데 시간을 들였으니 여러분은 그럴 필요가 없습니다.

단계 1: 의미 기반 검색

검색 쿼리는 OpenAI의 text-embedding-3-small 모델을 사용해 벡터로 변환된 뒤, 모든 공개된 스킬에 대해 미리 계산된 벡터와 비교됩니다. 가장 가까운 ~75개의 매치를 초기 후보군으로 뽑아냅니다.

스킬의 벡터는 무엇에 의해 결정될까요?
스킬의 전체 SKILL.md 파일—설명, 내용, 심지어 references/와 scripts/에 있는 파일들까지—전체를 하나의 텍스트 블롭으로 합친 뒤, 최대 12 000자까지 잘라서 임베딩합니다.

즉, 스킬의 내용이 크게 작용합니다.

단계 2: 토큰 매칭 필터

1단계에서 나온 후보들은 키워드 필터를 통과합니다. 쿼리는 토큰(소문자, 알파벳·숫자만)으로 분리되고, 각 후보의 이름, 슬러그, 요약이 검사됩니다. 쿼리 토큰 중 하나라도 해당 필드 토큰의 접두사와 일치하면 후보는 통과합니다.

이 필터는 매우 관대합니다. “video generator”를 검색하면 “video” 혹은 “generator”로 시작하는 토큰을 가진 모든 항목이 통과합니다. 실제 필터라기보다 일종의 sanity check에 가깝습니다.

단계 3: 정확한 슬러그 매치 보강

안전망: 쿼리 토큰을 하이픈으로 연결했을 때 기존 스킬의 슬러그와 정확히 일치하면, 해당 스킬을 강제로 후보 풀에 추가합니다.
예를 들어 ima-all-ai를 검색하면 벡터 검색에서 놓치더라도 해당 슬러그를 가진 스킬이 반드시 찾아집니다.

(이는 실제로 버그 수정으로 구현된 기능이며, 이전에는 정확한 슬러그 매치가 누락될 수 있었습니다.)

단계 4: 점수 계산

각 후보는 다음 세 부분으로 구성된 최종 점수를 받습니다:

finalScore = vectorScore + lexicalBoost + popularityBoost

어휘 보강 상세

보너스는 누적되므로, 슬러그와 이름 모두에 매치가 있으면 두 보너스를 모두 받습니다.

단계 5: 정렬 및 반환

결과는 finalScore가 높은 순으로 정렬되며, 동점일 경우 다운로드 수가 tiebreaker 역할을 합니다. 최상위 결과가 사용자에게 반환됩니다.

이게 전부—다섯 단계, 마법은 없습니다.

스킬 작성자에게 의미하는 바

스킬을 공개하고 사람들이 실제로 찾게 하려면, 다음 순서대로 중요한 요소들을 확인하세요:

1. 슬러그를 정확히 맞추세요

슬러그는 여러분이 가질 수 있는 가장 큰 레버입니다. 정확히 일치하는 슬러그는 +1.4를 부여하는데, 이는 대부분의 벡터 유사도 점수보다 큽니다. 사람들이 검색할 가능성이 높은 이름을 스킬에 지정하세요.

가이드라인

• 축약하지 마세요. 매칭은 쿼리 토큰이 슬러그 토큰의 접두사인지 확인합니다. "vid-gen"은 “video generator”를 검색하는 사람과 일치하지 않지만, "video-generator"는 일치합니다.
• 사람들이 입력하는 단어를 사용하세요. 멋져 보인다고 생각하는 단어가 아니라 실제 검색어를 사용하세요.
• 집중된 이름을 유지하세요. ai-video-generator가 ultimate-creative-suite-pro-v2보다 더 좋습니다.

2. 좋은 설명을 작성하세요

SKILL.md의 front‑matter에 있는 description 필드는 가장 중요한 부동산입니다. 임베딩 텍스트에서 가장 먼저 등장하며, 임베딩 모델은 텍스트 앞부분에 더 많은 주의를 기울입니다.

의미가 풍부하도록 간결하게 작성하세요. 스킬이 무엇을 하는지, 어떤 핵심 도구/모델과 함께 작동하는지를 포함하세요. 마케팅용 과장은 생략합니다.

# ✅ Good
description: "Generate images, videos, and music with 20+ AI models including Kling, Sora, Midjourney, and Suno"

# ❌ Bad
description: "The ultimate all‑in‑one AI creation toolkit for professionals"

두 번째 예시는 더 화려하게 들리지만, 스킬이 실제로 무엇을 하는지에 대한 정보를 검색 엔진에 거의 제공하지 못합니다.

3. SKILL.md를 앞부분에 집중시키세요

SKILL.md의 처음 ~500자에 가장 큰 가중치가 부여됩니다. 핵심 기능 설명을 그곳에 배치하세요. 설치 방법이나 전제 조건 같은 내용으로 시작하지 마세요—“pip install” 같은 문구는 검색되지 않습니다.

4. 사람들이 검색하는 다양한 방식 포괄하기

동일한 의도를 여러 방식으로 표현합니다. 콘텐츠가 자연스럽게 다양한 변형을 포함하도록 하세요:

• “generate video” / “create video” / “make video” / “text to video”
• “image generation” / “AI art” / “picture creation”

동의어를 남발하지 마세요; 임베딩은 유사한 의미를 같은 방향으로 압축합니다. 대신 다양한 사용 사례를 설명하여 자연스럽게 다른 단어를 사용하도록 하세요.

5. 구체적인 이름 포함하기

스킬이 특정 모델이나 서비스와 통합된다면, 그 이름을 명시하세요. 사람들은 “kling”이나 “midjourney”와 같은 키워드를 직접 검색합니다. 해당 단어가 스킬 텍스트에 없으면 해당 트래픽을 놓치게 됩니다.

6. Downloads Help, But Slowly

Downloads contribute to your score, but logarithmically.

• 0 → 100 다운로드에서 약 +0.37을 얻습니다.
• 100 → 1,000 다운로드에서는 추가로 +0.18만 더합니다.

다운로드 수에 집착하지 말고 — 먼저 위 항목에 집중하세요.

큰 그림

SDO는 아직 새로운 영역입니다. 이 마켓플레이스들은 겨우 1년 정도 되었고, 검색 알고리즘은 빠르게 진화하고 있습니다. 위에 링크한 PR은 정확히 일치하는 방식이 지난주에 바뀐 것과 같습니다.

하지만 기본 원칙은 크게 변하지 않을 것입니다:

당신의 스킬을 인간과 임베딩 모두가 이해하기 쉽게 만들고, 사람들이 검색할 만한 이름을 붙이며, 명확하게 설명하세요.

그것은 혁신적인 조언이 아니라, 20 년 전 SEO가 배운 교훈을 새로운 형태의 검색에 적용한 것과 같습니다.

• 전통적인 SEO에서는 크롤러와 순위 알고리즘을 최적화합니다.
• SDO에서는 임베딩 모델과 토큰 매처를 최적화합니다.

같은 게임이지만 규칙은 다릅니다.

ClawHub(또는 유사한 마켓플레이스)에 스킬을 게시한다면, SDO를 고려하세요. 복잡하지는 않지만, 이를 무시하면 스킬이 아무리 뛰어나도 보이지 않을 수 있습니다.

모든 분석은 2026년 3월 기준 ClawHub 소스 코드를 기반으로 합니다. 검색 알고리즘은 변하므로, 나중에 읽는 경우 현재 동작을 확인하세요.