依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。

MITAuto-check passedBackend & APIs

Install API Tester

skills CLI
$ npx skills add laolaoshiren/claude-code-skills-zh --skill api-tester -a claude-code

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

GitHub CLI
$ gh skill install laolaoshiren/claude-code-skills-zh api-tester --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/laolaoshiren/claude-code-skills-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/api-tester .claude/skills/api-tester && 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-tester
GitHub stars
879
Token cost
~614 tokens
SKILL.md length
146 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。

  • Works in 7 steps: 读取项目与接口证据 → 建立契约矩阵 → 明确环境与授权 → …
  • Tasks that involve OpenAPI specifications
  • SKILL.md covers 核心原则, 工作流程, 安全边界 and 输出
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

API Tester is an agent skill from laolaoshiren/claude-code-skills-zh. 依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering OpenAPI specifications. It works with OpenAPI. The repository describes itself as: 面向中文开发者的 Claude Code Skills / Agents / Plugins 精选与原创技能库|按场景分类|复制即装|持续更新. The licence is MIT.

When your agent uses it

  • Tasks that involve OpenAPI specifications

Example prompts

  • “/api-tester”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 读取项目与接口证据
  2. 建立契约矩阵
  3. 明确环境与授权
  4. 选择项目锁定的工具
  5. 设计有依据的用例
  6. 实现最小测试
  7. 执行与复验

What it can do on your machine

Read from SKILL.md and the folder at commit 633f21c. 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 markdown).

    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 Tester loads about 614 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 146 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~614

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

The full file from laolaoshiren/claude-code-skills-zh at commit 633f21c, republished under its MIT licence (© laolaoshiren). 146 words, ~614 tokens.

Download SKILL.mdSave it as .claude/skills/api-tester/SKILL.md (or your agent's skills folder).
name
api-tester
description
依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。

API 测试助手

核心原则

  • 只把可核验的 OpenAPI、代码、类型、调用方或现有测试当作契约证据。
  • 生成测试不等于执行测试;读取接口定义不等于可以访问真实服务。
  • 保护现有数据、凭据和用户修改,优先使用隔离且可清理的测试环境。

工作流程

1. 读取项目与接口证据

先读取适用的仓库规则、测试说明、Git 状态和项目脚本,再按实际存在情况检查:

  • OpenAPI / Swagger 文件及其引用的 Schema。
  • 路由、controller、handler、DTO、验证器和错误处理中间件。
  • 客户端类型、调用方、公开文档和现有 API 测试。
  • 测试配置、fixture、认证方式、环境变量模板和数据清理机制。

记录规范、实现与现有测试之间的不一致。无法确定哪个行为才是期望契约时,列出证据并请求确认,不用新测试固化猜测。

2. 建立契约矩阵

为目标 endpoint 记录:

项目证据
method 与 pathOpenAPI 或路由位置
认证与权限security scheme、中间件或调用方
请求参数与约束Schema、DTO 或验证器
已声明响应状态码、响应结构与 header
副作用与幂等性实现、文档或调用链
测试环境与清理fixture、事务或 teardown

不要默认每个接口都应返回 400、401、403、404、422 或 500。只有契约已声明或代码路径真实可达时才生成对应断言。

3. 明确环境与授权

在执行任何请求前确认:

  • Base URL、环境归属以及是否为 local、test、staging 或 production。
  • 测试账号、权限范围和凭据来源。
  • 是否允许执行 POST、PUT、PATCH、DELETE、上传、支付、通知等有副作用操作。
  • 测试数据隔离、唯一标识、清理或事务回滚方案。

用户只要求“生成测试”时只产出代码。生产环境、共享 staging、第三方服务及任何可能改变真实数据的执行都必须获得明确授权。GET 也不能仅凭 method 判定无副作用。

4. 选择项目锁定的工具
  • 优先运行仓库已有的 test、OpenAPI lint 或 contract test script。
  • 读取 package manager、lockfile 和已安装版本后再选择命令。
  • 不用裸 npx、全局工具或临时下载的最新版解析规范。
  • 缺少依赖时先报告;安装工具、更新 lockfile 或修改测试配置需要单独授权。
  • 使用真正的 YAML / JSON / OpenAPI 解析器,不用 grep 推断嵌套 Schema。
5. 设计有依据的用例

按目标契约选择必要场景:

  • 成功路径:使用最小合法输入验证状态、结构和关键语义。
  • 边界路径:只测试 Schema 或实现中真实存在的长度、范围、枚举、格式和必填约束。
  • 认证与权限:只覆盖已声明的身份、角色和资源归属规则。
  • 失败与回归:覆盖可达错误路径、已知缺陷或兼容性要求。
  • 幂等、分页、并发、重试与超时:仅在接口契约包含这些语义时测试。

断言外部可观察行为,避免绑定内部函数调用。随机数据应固定 seed,并避免真实个人信息、客户数据和生产标识。

6. 实现最小测试
  • 沿用项目现有框架、目录、fixture、命名和断言风格。
  • 单元测试可隔离网络、时间和第三方服务;集成测试使用受控服务或临时资源。
  • 对写操作使用唯一数据,并在成功、失败和中断路径都执行清理。
  • 不为让测试通过而擅自修改生产代码、接口规范或认证配置。
  • 使用跨平台路径和项目脚本;平台专属命令需说明 Windows / Linux 适用范围。
7. 执行与复验
  1. 先检查命令是否会下载依赖、访问外部服务或改变共享状态。
  2. 运行最小目标测试,记录命令、环境、退出状态和真实响应摘要。
  3. 按风险运行相关测试、类型检查或完整测试。
  4. 检查 Git diff 和环境状态,确认没有残留测试数据、快照、日志、Token 或无关生成物。
  5. 将基线已有失败与本轮新增失败分开报告。

没有实际运行时,只能说明“已生成、未验证”。没有明确 SLA 和受控测量条件时,不添加固定耗时断言或声称性能达标。

安全边界

  • 不在命令、日志、fixture 或报告中写入真实 Token、Cookie、密码和个人数据。
  • 未经明确授权,不访问生产环境、真实客户账号、付费 API 或受监管系统。
  • 压测、模糊测试、大批量数据生成和安全探测需要单独授权及限流方案。
  • 遇到权限不足、环境不明、清理方案缺失或响应可能含敏感信息时停止执行并报告。

输出

markdown
## API 测试结果

- 目标接口与契约证据:
- 环境与授权范围:
- 新增或修改文件:

## 用例

| 场景 | 契约依据 | 是否执行 | 结果 |
|------|----------|----------|------|

## 验证

- 实际命令与退出状态:
- 数据清理:
- 基线已有失败:
- 未确认契约与限制:

© laolaoshiren, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/api-tester of laolaoshiren/claude-code-skills-zh.

Open the folder on GitHubat commit 633f21c

Compare with similar skills

API Tester 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 Tester compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Tester this skilllaolaoshiren/claude-code-skills-zh879—~614Automated safety check: PassMIT
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Step Partsearthtojake/text-to-cad19k1 repos~1.5kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
API DesignerJeffallan/claude-skills12k1 repos~2kAutomated safety check: PassMIT

Similar skills

  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Step Parts

    earthtojake/text-to-cad

    Find, evaluate, and download common purchasable CAD parts from step.parts, including named off-the-shelf actuators, servos, motors, electronics boards, connectors, screws, bolts, nuts, washers…

    19k GitHub starsUsed in 1 repo~1.5k tokens
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 1 repo~2k tokens
    Backend & APIsAuto-check passed
  • CLI Creator

    huangruiteng/CS-Notes

    Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script.

    4k GitHub starsUsed in 2 repos~2.7k tokens
    Backend & APIsAuto-check passed

More from laolaoshiren/claude-code-skills-zh

All 19 skills in this repo
  • Dep Auditor

    laolaoshiren/claude-code-skills-zh

    审计 Node.js、Python、Go、Rust、JVM、Ruby 项目的依赖漏洞、版本健康度与许可证事实;当用户要求检查 package.json、lockfile、requirements、go.mod、Cargo.toml、pom.xml、Gemfile.lock,或生成不改依赖的中文审计报告时使用

    879 GitHub stars~895 tokensUpdated 4 days ago
    Auto-check passed
  • Eslint Fix

    laolaoshiren/claude-code-skills-zh

    安全诊断并修复 ESLint error、warning 和配置兼容问题。用于用户要求运行 lint、解释 ESLint 报错、限定范围自动修复或迁移 ESLint 配置时;优先使用项目锁定的包管理器与版本,先预检再修改,不自动下载最新版或批量改写无关源码。

    879 GitHub stars~436 tokensUpdated 4 days ago
    Auto-check passed
  • Git Workflow

    laolaoshiren/claude-code-skills-zh

    安全处理 Git 状态检查、提交信息、commit、分支、push、PR 和 rebase。用于用户要求检查改动、生成或创建提交、管理分支、推送、发起 PR 或整理历史时;严格区分每个动作的授权,并保护工作树中已有和无关的修改。

    879 GitHub stars~513 tokensUpdated 4 days ago
    Auto-check passed
  • GitHub Actions Gen

    laolaoshiren/claude-code-skills-zh

    分析真实项目并生成或修订安全、可验证的 GitHub Actions workflow;当用户要求创建 CI、测试矩阵、构建、Release、部署、缓存、Secrets、OIDC、PR 自动化或排查 workflow 配置时使用

    879 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check: notes
  • Skill Curator

    laolaoshiren/claude-code-skills-zh

    中文 Skill 收录评估器。用于核验 GitHub 上的 Claude Code、Codex、Agent Skills、Plugin、MCP、CLI 或 Agent 工作流是否值得加入精选列表;检查真实资产、安装方式、活跃度、重复项和安全边界,并生成分类、中文描述与可追溯证据。

    879 GitHub stars~756 tokensUpdated 4 days ago
    Auto-check passed
  • Zh Readme

    laolaoshiren/claude-code-skills-zh

    中文 README 生成器 - 先分析项目,再生成面向中文开发者的高质量 README. An agent skill from laolaoshiren/claude-code-skills-zh.

    879 GitHub stars~477 tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about API Tester

What does API Tester do?

依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。. API Tester is an agent skill from laolaoshiren/claude-code-skills-zh.

When should I use API Tester?

API Tester fits situations like: tasks that involve OpenAPI specifications.

How do I install API Tester in Claude Code?

Run `npx skills add laolaoshiren/claude-code-skills-zh --skill api-tester -a claude-code`. Or copy the skill folder (skills/api-tester in laolaoshiren/claude-code-skills-zh) into .claude/skills/api-tester in your project. Claude Code loads it when a task matches its description.

How do I install API Tester in Codex?

Run `npx skills add laolaoshiren/claude-code-skills-zh --skill api-tester -a codex`. Or copy the skill folder (skills/api-tester in laolaoshiren/claude-code-skills-zh) into .agents/skills/api-tester in your project. Codex loads it when a task matches its description.

Can I use API Tester 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 laolaoshiren/claude-code-skills-zh --skill api-tester -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-tester, .gemini/skills/api-tester, .github/skills/api-tester and .opencode/skills/api-tester in your project.

What does API Tester need to run?

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

Does API Tester 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 Tester 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 Tester use?

API Tester is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Tester use?

About 614 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Tester?

Skills that share tags, products or a category with API Tester: ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars), Step Parts (earthtojake/text-to-cad, 19k stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars) and Use Yaak (mountain-loop/yaak, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Tester?

laolaoshiren (a GitHub user) maintains it in laolaoshiren/claude-code-skills-zh, which has 879 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 5, 2026.

Source: laolaoshiren/claude-code-skills-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.