🔌
AI EngineeringPython

API Expert

by val1813

API Expert is an AI Engineering skill for Claude Code, published by val1813 in kwcode.

688 stars92 forkson val1813/kwcodeAdded 2026/07/14Repository updated 2026/05/14
Install in seconds
Install API Expert
Copy API Expert into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/val1813/kwcode/tree/master/kaiwu/builtin_experts/api ~/.claude/skills/api

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/val1813/kwcode.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
kaiwu/builtin_experts/api/SKILL.md in val1813/kwcode
Installs to
~/.claude/skills/api
Collection
One of 19 skills cataloged from this repository
Category
AI Engineering3670 skills

What API Expert does

A compact Chinese-language REST API design guide for Flask, FastAPI, Express, and Spring, with validation and error-handling conventions.

API Expert is cataloged under AI Engineering on DirSkills.

Reviewed 2026-08-04

DirSkills review

This is a compact Chinese-language rule set for guiding an AI coding agent through REST endpoint design; it is not a standalone API generator or runtime.

  • Best suited to reviewing or drafting CRUD endpoints for Flask, FastAPI, Express, and Spring projects.
  • Authentication, authorization, validation, persistence, and error behavior still need project-specific implementation and tests.

Documentation

README

领域知识

  • 资源命名用复数名词(/users, /orders),避免动词
  • HTTP方法语义:GET查询、POST创建、PUT全量更新、PATCH部分更新、DELETE删除
  • 状态码:200成功、201已创建、204无内容、400参数错误、401未认证、403无权限、404不存在、409冲突、422验证失败、500服务端错误
  • 分页:支持 ?page=1&size=20,响应包含 total/pages/current 元数据
  • 错误响应统一格式:{"code": int, "message": str, "details": [...]}
  • 认证:Bearer Token 放 Authorization header,不放 URL 参数
  • 版本控制:URL前缀 /api/v1/ 或 Accept header
  • 自动检测框架(Flask/FastAPI/Express/Spring)并适配对应路由注册方式
  • FastAPI 优先用 Pydantic model 做请求/响应校验
  • Express 用 router.route() 链式注册同路径不同方法

经验规则(自动生成)

Commands API Expert provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /orders

Frequently asked about API Expert

  • What else does val1813 publish alongside API Expert?

    API Expert is one of 19 skills that DirSkills catalogs from val1813/kwcode, the repository it ships in. Its siblings there include Bug Fix Expert, DeepSeek API Expert and Docstring Expert. Each one is a separate skill with its own page in this directory, installs the same way API Expert does, and is maintained by val1813 in that same repository. The rest of the collection is listed on the val1813/kwcode page.

  • How does API Expert compare to other AI Engineering skills?

    API Expert ranks #1745 by stars among the 3670 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of API Expert against them. Open each page to compare what they document and how they install.

More from val1813/kwcode

API Expert is one of 19 skills cataloged on DirSkills from val1813/kwcode.

See all 19 skills