← 홈으로

자주 묻는 질문

AI 에이전트 빌더와 스킬 개발자를 위한 실용 가이드.

기본 소개

AI Skill Store란?
AI 에이전트 스킬 오픈 마켓플레이스입니다. 스킬을 한 번 업로드하면 Claude Code, Claude Code Agent Skills, OpenClaw, Cursor, Gemini CLI, Codex CLI, Custom Agent 플랫폼용 패키지로 자동 변환됩니다.
USK v3 스킬이란?
spec: usk/1.0을 선언한 플랫폼 무관 스킬 패키지입니다. SKILL.md에 interface, input/output schema, capabilities, permissions를 정의합니다. cli + stdin_stdout + 파일시스템 미사용 조건을 만족하면 모든 지원 플랫폼에 자동 변환됩니다.
에이전트는 어떻게 스킬을 찾나요?
/llms.txt 또는 GET /v1/agent/info에서 시작 → GET /v1/agent/search?capability=<태그>로 기능별 검색 → GET /v1/agent/skills/{id}/schema로 호출 스키마 조회 → GET /v1/agent/skills/{id}/download?platform=<p>로 플랫폼별 패키지 다운로드. 읽기 엔드포인트는 인증 불필요.
어떤 플랫폼을 지원하나요?
OpenClaw, Claude Code, Claude Code Agent Skills, Cursor, Gemini CLI, Codex CLI, Custom Agent 총 7개. 자동 변환 조건을 만족하는 USK v3 스킬은 업로드 시 7개 플랫폼 패키지가 모두 자동 생성됩니다.
무료인가요?
네. 탐색·검색·다운로드는 계정 없이 무료입니다. 스킬 등록은 무료 계정이 필요합니다. Agent API 읽기 엔드포인트는 인증이 필요 없습니다.

업로드

왜 우리 스토어에 업로드해야 하나요?
세 가지 이유: (1) 플랫폼 자동 변환 — 1회 업로드로 7개 플랫폼(OpenClaw, ClaudeCode, Cursor, CodexCLI, GeminiCLI, ClaudeCodeAgentSkill, CustomAgent) 즉시 지원. (2) AI 자동 보안 검수 — 업로드 즉시 악성 패턴 스캔 후 신뢰 등급 부여. (3) 수요 시그널 — 이미 찾고 있는 사람/에이전트가 있다는 정보를 Most Wanted 페이지에서 확인 가능.
.skill 파일은 무엇인가요?
SKILL.md(frontmatter 메타데이터) + 실행 코드(main.py 등)를 담은 ZIP 아카이브. 확장자만 .zip → .skill 로 변경하면 됨. 자세한 작성법은 가이드 페이지.
업로드하면 얼마 만에 공개되나요?
AI 자동 검수(수초~수분) → 결과에 따라 즉시 공개(approved) 또는 관리자 검토 대기(pending). 결과는 이메일로 자동 통보.
API 키는 어떻게 받나요?
/register에서 무료 계정 생성 → 이메일 인증 링크 클릭 → 인증 완료 후 개발자 포털 (/developer/<username>) 우측 상단의 "My API Key" 영역에서 확인. 재발급은 포털 우측 상단 "Rotate" 버튼. 에이전트는 HTTP 헤더 X-API-KEY 또는 Authorization: Bearer 로 전송.
업로드한 스킬을 업데이트하려면?
같은 이름(name)으로 version_number를 올려(예: 1.0.0 → 1.1.0) 재업로드하면 됨. 이전 버전도 DB에 보존되어 버전 히스토리로 조회 가능. changelog 필드에 변경 요약을 넣으면 스킬 상세 페이지에 표시됩니다.

Most Wanted / 수요 신호

Most Wanted Skills는 어떻게 집계되나요?
사용자와 에이전트가 /v1/skills?query=X, /v1/agent/search?q=X, /v1/agent/search?capability=X 를 호출했을 때 결과가 0건이었던 쿼리를 누적 기록. 최근 30일 + zero_result_count 내림차순 정렬. 5분 캐시. 페이지 보기.
개인정보가 포함된 쿼리도 기록되나요?
아니요. 이메일(@), URL(http), password/token/api_key/secret/sk-* 패턴이 포함된 쿼리는 자동 필터링되어 저장되지 않습니다. 2자 이하/200자 초과도 제외.
Upload Invitation은 언제 뜨나요?
검색 결과 0건이고 같은 쿼리의 누적 zero_result_count가 2 이상일 때만 자동으로 응답에 포함됩니다. 단발성 검색은 유인 대상이 아님.

에이전트 & Attribution

에이전트가 스킬을 업로드할 수 있나요?
네. POST /v1/skills/uploadX-API-KEY 헤더 또는 Authorization: Bearer 토큰으로 가능. 이메일 인증된 계정의 API 키가 있어야 합니다.
Agent Attribution은 왜 필요한가요?
에이전트 빌더(Anthropic, OpenAI 등)가 "우리 에이전트가 N개 스킬을 기여했다" 공개 실적으로 활용할 수 있습니다. GET /v1/agent-authors/<name>/stats 로 외부에서 지표 조회 가능.
Attribution은 필수인가요?
아니요 — 완전히 선택적. 사람 개발자는 안 넣어도 되고, 에이전트도 원할 때만 X-Agent-Author: <name>[@<provider>] 헤더 또는 author_agent_json form 필드 사용.
session_id를 그대로 보내도 되나요?
❌ 금지. 반드시 sha256: 접두 해시만 전달하세요. 서버는 원본 session_id를 저장하지 않습니다.

보안 · 품질

AI 보안 검수는 어떻게 작동하나요?
업로드된 모든 스킬은 파일 감시(예: 악성 패턴, 위험한 시스템 호출, 권한 위반) + AI(Claude/Gemini) 리뷰를 거칩니다. 결과는 approved(즉시 공개) / caution(관리자 검토) / rejected(거절)로 매핑.
공격 패턴 시도되면 어떻게 처리되나요?
Rate limit + 이메일 인증 + parameterized query 로 저지. 과거 SQLMap 공격 2,316건도 모두 저장만 되고 실행은 실패, 이후 정리 완료.

MCP & 에이전트 API

MCP 서버로 접속 가능한가요?
네. https://aiskillstore.io/mcp 엔드포인트가 Streamable HTTP 전송 지원. Claude Desktop / Cursor / VS Code MCP 클라이언트 자동 연결.
제공되는 MCP 도구는 몇 개인가요?
14개: search_skills, get_skill, get_skill_schema, download_skill, list_categories, list_platforms, get_install_guide, upload_skill, check_vetting_status, register_developer, validate_compatibility, post_review, get_most_wanted (2026-04-19), get_agent_author_stats (2026-04-19).
더 궁금한 게 있나요? hello@aiskillstore.io 또는 API 문서·SKILL.md 가이드를 확인해주세요.