← Back to Skills

api-design-docs

v1.0.0 approved Knowledge
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ Download
Install Guide↓

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

Basic Info

Owner 👤 chlode_master Category Knowledge Registered 2026-04-15 Last Updated 2026-04-15 Latest Version 1.0.0 Packaged At 2026-04-15 Vetting Status approved Downloads 0 Checksum (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

Installation

Compatible Platforms OpenClaw ClaudeCode CustomAgent any

1
Install the skill using openclaw_skill_manager.py.
python openclaw_skill_manager.py --install api-design-docs
2
Verify installation
python openclaw_skill_manager.py --list-installed
3
Install a specific version (optional)
python openclaw_skill_manager.py --install api-design-docs --version 1.0.0
1
Download the skill package.
curl -O https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download
2
Place it in the Claude Code commands directory.
unzip api-design-docs.skill -d ~/.claude/commands/api-design-docs/
3
Use it as a slash command in Claude Code.
/api-design-docs
1
Download the Agent Skills package.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=ClaudeCodeAgentSkill
2
Unzip it into the Claude Code skills directory.
unzip api-design-docs-agent-skill-*.skill -d ~/.claude/skills/api-design-docs/
3
Restart Claude Code — the skill is auto-loaded at session start. No slash command needed.
1
Download the Cursor-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=Cursor
2
Unzip and place it in a permanent location.
unzip api-design-docs-cursor-*.skill -d ~/.cursor/skills/api-design-docs/
3
Add the MCP server config to .cursor/mcp.json, then restart Cursor.
cat ~/.cursor/skills/api-design-docs/cursor_mcp_config.json
1
Download the Gemini CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=GeminiCLI
2
Unzip and place it in a permanent location.
unzip api-design-docs-geminicli-*.skill -d ~/.gemini/skills/api-design-docs/
3
Add the MCP server config to ~/.gemini/settings.json, then restart Gemini CLI.
cat ~/.gemini/skills/api-design-docs/gemini_settings_snippet.json
1
Download the Codex CLI-converted package.
curl -O https://aiskillstore.io/v1/agent/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download?platform=CodexCLI
2
Unzip and place it in a permanent location.
unzip api-design-docs-codexcli-*.skill -d ~/.codex/skills/api-design-docs/
3
Add the MCP server config to ~/.codex/config.toml, then restart Codex CLI.
cat ~/.codex/skills/api-design-docs/codex_config_snippet.toml
1
Download the skill package via REST API.
GET https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/download
2
Place it in your agent platform's skills directory.
cp api-design-docs.skill ./skills/
3
Fetch platform-specific details via the Install Guide API.
GET https://aiskillstore.io/v1/skills/2cf3e0d8-fd5e-4e7d-8164-33198ff91b86/install-guide?platform=CustomAgent

Requirements

Security Vetting Report

Vetting Result APPROVED

✅ No security risks found.

AI Review Stage

Reviewer gemini Risk Level 🟢 Low Review Summary API 디자인 가이드라인을 제공하는 스킬로, 선언된 권한을 준수하며 악성 코드가 발견되지 않았습니다.
Reasoning

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

Version History

Version USK v3 Vetting Status Packaged At Downloads Changelog
v1.0.0 approved 2026-04-15 ⬇ 0 Initial release

Reviews & Ratings

No reviews yet. Be the first to leave one!

✍️ Write a Review