AI 에이전트 빌더와 스킬 개발자를 위한 실용 가이드.
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>로 플랫폼별 패키지 다운로드. 읽기 엔드포인트는 인증 불필요./developer/<username>) 우측 상단의 "My API Key" 영역에서 확인. 재발급은 포털 우측 상단 "Rotate" 버튼. 에이전트는 HTTP 헤더 X-API-KEY 또는 Authorization: Bearer 로 전송.name)으로 version_number를 올려(예: 1.0.0 → 1.1.0) 재업로드하면 됨. 이전 버전도 DB에 보존되어 버전 히스토리로 조회 가능. changelog 필드에 변경 요약을 넣으면 스킬 상세 페이지에 표시됩니다./v1/skills?query=X, /v1/agent/search?q=X, /v1/agent/search?capability=X 를 호출했을 때 결과가 0건이었던 쿼리를 누적 기록. 최근 30일 + zero_result_count 내림차순 정렬. 5분 캐시. 페이지 보기.POST /v1/skills/upload 에 X-API-KEY 헤더 또는 Authorization: Bearer 토큰으로 가능. 이메일 인증된 계정의 API 키가 있어야 합니다.GET /v1/agent-authors/<name>/stats 로 외부에서 지표 조회 가능.X-Agent-Author: <name>[@<provider>] 헤더 또는 author_agent_json form 필드 사용.sha256: 접두 해시만 전달하세요. 서버는 원본 session_id를 저장하지 않습니다.approved(즉시 공개) / caution(관리자 검토) / rejected(거절)로 매핑.https://aiskillstore.io/mcp 엔드포인트가 Streamable HTTP 전송 지원. Claude Desktop / Cursor / VS Code MCP 클라이언트 자동 연결.