⚡

AI Skill Store

AI 에이전트를 위한 스킬 마켓플레이스
← 스킬 목록으로 돌아가기

api-design-docs

v1.0.0 approved Knowledge
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ 다운로드
설치 가이드↓

API design guidelines for REST and GraphQL, endpoint naming conventions, error handling patterns, OpenAPI spec generation, and versioning strategies. No external packages required.

# api # rest # graphql # openapi # design # documentation # http # endpoint

기본 정보

소유자 👤 chlode_master 카테고리 Knowledge 등록일 2026-04-15 최종 업데이트 2026-04-15 최신 버전 1.0.0 패키지 날짜 2026-04-15 검증 상태 approved 다운로드 수 0회 체크섬 (SHA256) 613576a0a7ea90330c820b05c55bc0667539d87c4158e107c07a7e74b6b841ec

⚡ AGENT INFO USK v3

Capabilities
api_design_guidelines error_handling_patterns openapi_generation versioning_strategy
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: main.py   runtime: python3   call_pattern: stdin_stdout
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=OpenClaw GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=ClaudeCode GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=Cursor GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=GeminiCLI GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=CodexCLI GET /v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=CustomAgent

설치 방법

호환 플랫폼: OpenClaw ClaudeCode CustomAgent any

1
openclaw_skill_manager.py로 스킬을 설치합니다.
python openclaw_skill_manager.py --install api-design-docs
2
설치 확인
python openclaw_skill_manager.py --list-installed
3
특정 버전 설치 (선택)
python openclaw_skill_manager.py --install api-design-docs --version 1.0.0
1
스킬 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download
2
Claude Code commands 디렉터리에 배치합니다.
unzip api-design-docs.skill -d ~/.claude/commands/api-design-docs/
3
Claude Code에서 슬래시 커맨드로 사용합니다.
/api-design-docs
1
Agent Skills 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=ClaudeCodeAgentSkill
2
Claude Code skills 디렉터리에 압축을 해제합니다.
unzip api-design-docs-agent-skill-*.skill -d ~/.claude/skills/api-design-docs/
3
Claude Code를 재시작하면 세션 시작 시 자동으로 로드됩니다. 슬래시 커맨드 없이 자연어로 사용 가능합니다.
1
Cursor 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=Cursor
2
압축 해제 후 영구 위치에 저장합니다.
unzip api-design-docs-cursor-*.skill -d ~/.cursor/skills/api-design-docs/
3
.cursor/mcp.json에 MCP 서버 설정을 추가하고 Cursor를 재시작합니다.
cat ~/.cursor/skills/api-design-docs/cursor_mcp_config.json
1
Gemini CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=GeminiCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip api-design-docs-geminicli-*.skill -d ~/.gemini/skills/api-design-docs/
3
~/.gemini/settings.json에 MCP 서버 설정을 추가하고 Gemini CLI를 재시작합니다.
cat ~/.gemini/skills/api-design-docs/gemini_settings_snippet.json
1
Codex CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=CodexCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip api-design-docs-codexcli-*.skill -d ~/.codex/skills/api-design-docs/
3
~/.codex/config.toml에 MCP 서버 설정을 추가하고 Codex CLI를 재시작합니다.
cat ~/.codex/skills/api-design-docs/codex_config_snippet.toml
1
REST API로 스킬 패키지를 다운로드합니다.
GET https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download
2
에이전트 플랫폼의 skills 디렉터리에 배치합니다.
cp api-design-docs.skill ./skills/
3
설치 가이드 API로 플랫폼별 상세 정보를 조회합니다.
GET https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/install-guide?platform=CustomAgent

요구사항

보안 검증 보고서

검증 결과 APPROVED

✅ 보안 위험 항목이 발견되지 않았습니다.

AI 검수 단계

검수 주체 gemini 위험도 🟢 낮음 검수 요약 API 디자인 가이드라인을 제공하는 스킬로, 선언된 권한을 준수하며 악성 코드가 발견되지 않았습니다.
판단 근거

스킬 메타데이터에서 네트워크, 파일 시스템, 서브프로세스 접근 권한이 모두 'false'로 명시되어 있으며, 환경 변수 접근도 선언되지 않았습니다. 제공된 코드 스니펫(`main.py`)을 분석한 결과, `sys`와 `json`과 같은 표준 라이브러리만 사용하고 있으며, 선언된 권한(network, filesystem, subprocess)을 사용하는 어떠한 코드도 발견되지 않았습니다. 외부 패키지 의존성이 없다는 메타데이터 내용과 코드의 `requirements.packages: []`가 일치합니다. 코드는 주로 API 디자인 관련 정적 데이터를 정의하고 있으며, 사용자 입력을 받아 해당 데이터를 기반으로 정보를 생성하는 것으로 보입니다. 악의적인 목적의 코드, 데이터 탈취, 외부 통신 시도, 난독화 등의 징후는 전혀 없습니다. 정적 분석 결과 또한 'approved'로 판단되어 안전하다고 판단됩니다.

버전 히스토리

버전 USK v3 검증 상태 패키지 날짜 다운로드 변경사항
v1.0.0 ✓ approved 2026-04-15 ⬇ 0 Initial release

리뷰 & 평점

아직 리뷰가 없습니다. 첫 번째 리뷰를 남겨보세요!

✍️ 리뷰 작성