Agent skill

API Design Safety

by doccker in doccker/cc-use-exp

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

Custom licenceAuto-check passedBackend & APIs

Install API Design Safety

skills CLI
$ npx skills add doccker/cc-use-exp --skill api-design-safety -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install doccker/cc-use-exp api-design-safety --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/doccker/cc-use-exp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/api-design-safety .claude/skills/api-design-safety && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-design-safety
GitHub stars
1.1k
Token cost
~2.6k tokens
SKILL.md length
449 words
Files
2 (incl. references)
Skills in repo
67
Repo updated
First seen
Licence
Custom licence

At a glance

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

  • Tasks that involve API design
  • SKILL.md covers 陷阱 #1: 泛型方法重载歧义, 陷阱 #2: 响应字段语义不清, 陷阱 #3: 空值处理不一致 and 陷阱 #4: HTTP 状态码与业务状态码混淆, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Excel spreadsheets

What it does

API Design Safety is an agent skill from doccker/cc-use-exp. 当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/multi-lang-examples.md`).

It sits in Backend & APIs, covering API design, Excel spreadsheets and REST APIs. It works with Microsoft Excel. The repository describes itself as: ⛔ No longer maintained → dev-agent-kit/recipes 让 Claude Code、Antigravity、Gemini CLI、Codex、Cursor 开箱即用的分层配置模板,总结十多年的日常开发经验.

When your agent uses it

  • Tasks that involve API design
  • Tasks that involve Excel spreadsheets
  • Tasks that involve REST APIs

Example prompts

  • “/api-design-safety”

What it can do on your machine

Read from SKILL.md and the folder at commit 64470cb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are java).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Design Safety loads about 2.6k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 449 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 449 words (~2,594 tokens).

name
api-design-safety

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in .claude/skills/api-design-safety of doccker/cc-use-exp.

  • SKILL.md
  • references/multi-lang-examples.md

Open the folder on GitHubat commit 64470cb

Compare with similar skills

API Design Safety next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Design Safety compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Design Safety this skilldoccker/cc-use-exp1.1k—~2.6kAutomated safety check: PassCustom licence
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
Toxynissl-lab/toxy463—~1.7kAutomated safety check: PassApache-2.0
Documentszhongkaifu/TensorSharp553—~4.2kAutomated safety check: PassBSD-3-Clause
PullmdAeternaLabsHQ/pullmd486—~2.6kAutomated safety check: PassAGPL-3.0
Openclaw Rpalaziobird/openclaw-rpa229—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • Toxy

    nissl-lab/toxy

    A skill your agent uses whenever the user wants to extract text or data from documents using Toxy (the .NET text extraction library).

    463 GitHub stars~1.7k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Documents

    zhongkaifu/TensorSharp

    Read and write real documents on the device - PDF, XLSX, DOCX, PPTX and CSV.

    553 GitHub stars~4.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Pullmd

    AeternaLabsHQ/pullmd

    Read any web page, document, or YouTube video as clean Markdown using PullMD.

    486 GitHub stars~2.6k tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Openclaw Rpa

    laziobird/openclaw-rpa

    Record browser, Excel, Word & API actions once — replay without the LLM: faster, cheaper, no hallucinations.

    229 GitHub stars~2.4k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Markdown Exporter

    bowenliang123/markdown-exporter

    Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

    271 GitHub starsUsed in 1 repo~5.3k tokens
    Documents & OfficeAuto-check passed

More from doccker/cc-use-exp

All 67 skills in this repo
  • Cc Code Quality Principles

    doccker/cc-use-exp

    当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

    1.1k GitHub stars~816 tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Review

    doccker/cc-use-exp

    结构化代码审查工作流,适用于显式 quick/full/security review;不负责普通实现或 bug 修复流程。

    1.1k GitHub stars~541 tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Streaming Export Safety

    doccker/cc-use-exp

    当实现用户驱动的大文件导出或批量序列化(Excel/CSV/JSON/JSONL/PDF,数据量未知或超过 1 万行/10 MB)时触发;普通小文件下载、静态资源下载、非导出 Writer/Report 类不触发。防止 OOM、临时文件残留、同步导出阻塞 HTTP 线程和表格公式注入。

    1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Code Quality Principles

    doccker/cc-use-exp

    当编写新模块、设计接口、重构代码或代码审查时触发。提供经典模块化六原则检查清单(大小适中/调用深度/扇入扇出/边界清晰/作用域内聚/可预测性),适用于 PR/Review/新模块设计场景。

    1.1k GitHub stars~803 tokensUpdated 1 mo ago
    Auto-check passed
  • External System Debugging

    doccker/cc-use-exp

    涉及浏览器、编辑器、CDN/WAF、IM 平台、操作系统剪贴板、第三方 SaaS 等"外部黑盒系统"的代码编写或 bug 调试时触发。强制先抓真实环境数据再推理,避免连续 2 轮"凭代码推理"的修复 no-op。关键词:粘贴/复制异常、跨平台显示不一致、第三方 API 怪结果、CDN/WAF 拦截、本地复现失败、HTML→MD 转换丢属性。

    1.1k GitHub stars~823 tokensUpdated 1 mo ago
    Auto-check passed
  • Frontend Dev

    doccker/cc-use-exp

    前端开发规范,包含 Vue 3 编码规范、UI 风格约束、TypeScript 规范等. An agent skill from doccker/cc-use-exp.

    1.1k GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about API Design Safety

What does API Design Safety do?

当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。. API Design Safety is an agent skill from doccker/cc-use-exp.

When should I use API Design Safety?

API Design Safety fits situations like: tasks that involve API design; tasks that involve Excel spreadsheets; tasks that involve REST APIs.

How do I install API Design Safety in Claude Code?

Run `npx skills add doccker/cc-use-exp --skill api-design-safety -a claude-code`. Or copy the skill folder (.claude/skills/api-design-safety in doccker/cc-use-exp) into .claude/skills/api-design-safety in your project. Claude Code loads it when a task matches its description.

How do I install API Design Safety in Codex?

Run `npx skills add doccker/cc-use-exp --skill api-design-safety -a codex`. Or copy the skill folder (.claude/skills/api-design-safety in doccker/cc-use-exp) into .agents/skills/api-design-safety in your project. Codex loads it when a task matches its description.

Can I use API Design Safety in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add doccker/cc-use-exp --skill api-design-safety -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-design-safety, .gemini/skills/api-design-safety, .github/skills/api-design-safety and .opencode/skills/api-design-safety in your project.

What does API Design Safety need to run?

SKILL.md names no scripts, command-line tools or credentials: API Design Safety is instructions for the agent only.

Does API Design Safety access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Design Safety safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does API Design Safety use?

API Design Safety has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does API Design Safety use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.8k tokens, read only when the agent opens those files.

What are the alternatives to API Design Safety?

Skills that share tags, products or a category with API Design Safety: XLSX (rvdbreemen/OTGW-firmware, 207 stars), Toxy (nissl-lab/toxy, 463 stars), Documents (zhongkaifu/TensorSharp, 553 stars) and Pullmd (AeternaLabsHQ/pullmd, 486 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Design Safety?

doccker (a GitHub user) maintains it in doccker/cc-use-exp, which has 1,063 GitHub stars. The repository holds 67 skills in this directory. The repository was last updated on August 26, 2026.

Source: doccker/cc-use-exp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.