anxiong2025/25-day-agents-course-by-google/api-designer

Claude Code and agent skill by anxiong2025/25-day-agents-course-by-google

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

帮助设计 RESTful API，遵循最佳实践和一致的命名规范

Install

npx vskill@latest install anxiong2025/25-day-agents-course-by-google/api-designer

SKILL.md

API Designer Skill

当用户请求设计 API 或讨论 API 结构时，应用此技能。

RESTful 设计原则

URL 命名规范
# 资源集合 - 复数名词
GET    /users          # 获取用户列表
POST   /users          # 创建用户
 
# 单个资源
GET    /users/{id}     # 获取特定用户
PUT    /users/{id}     # 更新用户（全量）
PATCH  /users/{id}     # 更新用户（部分）
DELETE /users/{id}     # 删除用户
 
# 嵌套资源
GET    /users/{id}/orders    # 用户的订单
HTTP 状态码
状态码含义使用场景
200OK成功的 GET/PUT/PATCH
201Created成功的 POST
204No Content成功的 DELETE
400Bad Request请求参数错误
401Unauthorized未认证
403Forbidden无权限
404Not Found资源不存在
422Unprocessable Entity验证失败
500Internal Server Error服务器错误
响应格式
json
{
  "data": {
    "id": "123",
    "type": "user",
    "attributes": {
      "name": "张三",
      "email": "zhang@example.com"
    }
  },
  "meta": {
    "timestamp": "2025-01-01T00:00:00Z"
  }
}
分页
json
{
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "total_pages": 5
  }
}
错误响应
json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "请求参数验证失败",
    "details": [
      {
        "field": "email",
        "message": "邮箱格式不正确"
      }
    ]
  }
}

API 文档模板

为每个端点提供：

  1. 端点: METHOD /path
  2. 描述: 功能说明
  3. 请求参数: Query/Path/Body 参数
  4. 响应示例: 成功和失败情况
  5. 权限要求: 需要的认证/授权

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
205
Repository forks
63
7-day trend score
27

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 19 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/anxiong2025/25-day-agents-course-by-google/api-designer/badge)](https://verified-skill.com/skills/anxiong2025/25-day-agents-course-by-google/api-designer)

Something wrong with this skill or its page? Tell us.