api SKILL.md skillA
api from wangqiqi/cursor-ai is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add wangqiqi/cursor-ai/api@git:20261116.6085164Pins git:20261116.6085164 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- wangqiqi/cursor-ai
- Path
.cursor/harness/core/skills/api/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261116.6085164, committed Nov 16, 2026
- First version recorded
- Oct 26, 2026
- Size
- 2,792 bytes
- Repository stars
- 4
- License
- none declared
REST/OpenAPI 设计审查。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# api · 审查清单
契约变更须同 PR 更新 server + client + mocks(见 `rules/execution/api.mdc`)。
## URL 与资源
- [ ] 资源名词复数、小写、kebab-case(`/users` 非 `/getUsers`)
- [ ] 嵌套 ≤2 层;深嵌套改 query 或独立资源
- [ ] 版本策略一致(`/v1/` 或 header,全项目统一)
- [ ] 幂等写操作(PUT/DELETE)语义正确
## 请求与响应
- [ ] 稳定 error code / error type(非仅自由文本 message)
- [ ] HTTP 状态码语义正确(401 vs 403、404 vs 410)
- [ ] 分页一种风格(cursor **或** offset,不混用);列表信封见 `reference/list-pagination-contract.md`
- [ ] 日期/时间 ISO-8601;枚举与 OpenAPI schema 一致
## 安全与校验
- [ ] 写路径 auth + 输入校验
- [ ] 敏感字段不在 GET list 中过度暴露
- [ ] Rate limit / 体量限制对公开端点有考虑
## 边界与默认(二级 · `input-bounds.mdc`)
- [ ] 数值参数有文档化上下限(越界 clamp 或 4xx)
- [ ] 枚举/模式字段白名单;未知值拒绝或安全回退
- [ ] 分页 `limit` 等有上限,禁止无界拉取
- [ ] 配置类输入非法时可回退并记录,不半开服务
## 契约同步
- [ ] OpenAPI/spec 与实现同 PR 更新
- [ ] Client types / API wrapper 已跟进
- [ ] Mock/fixture enum 与 server 校验一致
- [ ] Breaking change 在 CHANGELOG 标明
## 反模式(标 High)
- 仅改后端字段名不更新 client
- 200 + `{ "error": "..." }` 代替 4xx
- 示例与 schema 不一致
- **同 method+path 重复注册**(后者被遮蔽或行为不确定)
## 路由表面(HTTP 注册)
- [ ] 应用内 `(method, normalized-path)` **无新增 duplicate**
- [ ] 框架**先注册优先**时:不同 handler 不得共用同 path(常见 bug:复制粘贴 path)
…Read the whole file at its exact version.
How to install
claude plugin marketplace add https://markdownregistry.com/mp/a/art_3yplhizihif3frkw/573432b663f0eaeab0e4529c7c0d858652e29e42e5fce7d8a2b13d9d4e796072.json
Then /plugin install api@markdownregistry-3yplhizihif3frkw in Claude Code. It installs git:20261116.6085164, the one graded A here, pinned to the commit it was graded at, and leaves it there.
mdr add wangqiqi/cursor-ai/api@sha256:573432b663f0eaeaThe line at the top of this page pins the label git:20261116.6085164, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_3yplhizihif3frkw)
2 badge image fetches in 30 days. What the badge shows.
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry
Then ask it: what changed in wangqiqi/cursor-ai/api since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.
Got a copy of api from somewhere else? Ask it: where did my api come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.
Versions
The registry has recorded 2 versions of this file, between Oct 26, 2026 and Nov 16, 2026, about one every 21 days.
Watch this file (sign in, one email per new version)
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261116.6085164 latest | 2026-11-16 | 6085164 | 2,792 B | A | view · diff |
| git:20261026.8d01e18 | 2026-10-26 | 8d01e18 | 2,223 B | A | view |
Committed this skill to a repository? Install the markdownregistry skill updates app on it, or on all of them. When the registry saves a newer version, a pull request brings your copy to it within minutes, the newest version first, then what changed and any check it newly trips. A copy you edited is never touched, and nothing is deleted.
It asks to read and write contents and pull requests, and to read metadata. No workflow file, no Actions setting, nothing runs on your runners. Uninstall it and everything the registry kept about your repository is deleted.
Committed this skill to a repository? Add one workflow file, and when a newer version is saved, a pull request brings your copy to it, the newest version first, then what changed and any check it newly trips. A copy you edited is never touched, and nothing is deleted.
mkdir -p .github/workflows && curl -fsSL https://markdownregistry.com/ci/skill-updates.yml -o .github/workflows/skill-updates.yml
It runs daily on GitHub Actions, no key and no account. Read the workflow before you add it.
Installed this file, say at .claude/skills/api/SKILL.md? Drop it here to learn which saved version you have and what changed since. Your browser works out its SHA-256 fingerprint and sends only that; the file itself never leaves your computer.
Or paste its contents
Your agent can run this same check on the agent markdown files you have installed, up to 50 in one ask. Add the registry once:
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry
Then ask it to check the files you have installed. No key and no account.
From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.
sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies
In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.
sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies
No sha256sum on your machine? shasum -a 256 prints the same lines.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2792 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
wangqiqi/cursor-ai · 4 stars · license none declared · pushed 2026-11-17 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_3yplhizihif3frkw GET https://markdownregistry.com/api/v1/resolve?ref=wangqiqi/cursor-ai/api GET https://markdownregistry.com/api/v1/blob/573432b663f0eaeab0e4529c7c0d858652e29e42e5fce7d8a2b13d9d4e796072
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from wangqiqi/cursor-ai
Every file in wangqiqi/cursor-ai