api-and-interface-design
Use for public APIs, schemas, events, config, or consumed module boundaries.
Skill by shiyuan17
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/shiyuan17-api-and-interface-design
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: design, backend
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/api-and-interface-design
What's inside
- Skill name
api-and-interface-design- Description
- Use for public APIs, schemas, events, config, or consumed module boundaries.
- License
- MIT
- Instructions
- 22 lines in SKILL.md · view on GitHub
Files (3)
- SKILL.md
- openai.yaml · agents/
- metadata.json
SKILL.md (first lines)
# 设计接口契约 以现有契约和调用方为真值，先固定边界再实现。 同步归属：`docs/rules/api-rules.md`；两者描述同一契约，修改须同步。 ## 执行 1. 找到契约来源、生产者、消费者和兼容窗口。 2. 明确输入、输出、错误、权限、可空性、分页、幂等、重试与并发冲突语义。 3. 在外部边界校验输入并限制大小与频率，保持内部类型可信；不要臆造字段或错误码。 4. 优先做可加的兼容演进；改名、改类型、改语义或收紧校验时设计迁移、弃用路径与回滚。 5. 同步 mapper、mock、文档和两侧契约测试。 6. 用真实调用路径证明生产者与消费者一致，不以单侧测试替代。 契约来源、owner、兼容性或迁移决定未定时，暂停依赖该决定的实现，列出缺口并继续可独立核验的部分；未完成两侧验证时不得声称集成通过。 ## 交付 报告契约来源、兼容影响、迁移方式、两侧验证和剩余未决项。
From shiyuan17/Vibe-Harness, MIT.
More from shiyuan17/Vibe-Harness
- 0.570score
agentmemory
shiyuan17
Use when saving, recalling, resuming, forgetting, summarizing, or listing Agentmemory project memories and sessions, including commit history and commit…
SkillAFreshness: AClaude Code +9 - 0.570score
stale-cleanup
shiyuan17
Use when cleaning dead code, stale references, outdated docs, orphan resources, stale memory, or stale indexes; producing evidence-based removal lists; or…
SkillAFreshness: AClaude Code +9 - 0.567score
clarify-requirements
shiyuan17
Use for unresolved product choices or explicit requirements discovery—not discoverable facts, implementation details, approvals, or final goals.
SkillAFreshness: AClaude Code +9 - 0.565score
systematic-debugging
shiyuan17
Use when a specific failure, error, or flaky test needs its root cause proven before fixing—not for applying known fixes.
SkillAFreshness: AClaude Code +9 - 0.564score
frontend-design
shiyuan17
Use for frontend visual direction, polish, responsiveness, or redesign—not logic-only work.
SkillAFreshness: AClaude Code +9 - 0.564score
define-goal
shiyuan17
Use to write, refine, or activate `/goal` or execution/exploration objectives—not goal status operations.
SkillAFreshness: AClaude Code +9 - 0.561score
eval-driven-development
shiyuan17
Use for nondeterministic Agent rules, Skills, prompts, Hooks, or routing—not deterministic logic, bug fixes with known causes, or deterministic refactors.
SkillAFreshness: AClaude Code +9 - 0.561score
vb-git-develop-flow
shiyuan17
Use only when explicitly requested as Vb Git Develop Flow, $vb-git-develop-flow, or legacy gd-flow to deliver through an isolated worktree into develop; never…
SkillAFreshness: AClaude Code +9 - 0.561score
vb-git-split-push
shiyuan17
Use only when explicitly requested as Vb Git Split Push, $vb-git-split-push, or legacy $git-deliver to commit task changes in logical groups and push the…
SkillAFreshness: AClaude Code +9 - 0.559score
bug-finding
shiyuan17
Use when reviewing existing code for latent logic, flow, feature, state, consistency, requirement, or API bugs with no failing symptom—read-only audit, not…
SkillAFreshness: AClaude Code +9 - 0.558score
task-decomposition
shiyuan17
Use to split implementation plans into a Goal, Task DAG, and prompts for verifiable work.
SkillAFreshness: AClaude Code +9 - 0.553score
security-and-hardening
shiyuan17
Use for trust boundaries, untrusted input, auth, secrets, sensitive data, or external writes.
SkillAFreshness: AClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Oct 14, 2026 (15 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/shiyuan17/Vibe-Harness
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Same skill elsewhere
Copies of this SKILL.md published by others; search shows only one of them.
More from shiyuan17
- 0.570score
agentmemory
shiyuan17
Use when saving, recalling, resuming, forgetting, summarizing, or listing Agentmemory project memories and sessions, including commit history and commit…
SkillAFreshness: AClaude Code +9 - 0.570score
stale-cleanup
shiyuan17
Use when cleaning dead code, stale references, outdated docs, orphan resources, stale memory, or stale indexes; producing evidence-based removal lists; or…
SkillAFreshness: AClaude Code +9 - 0.567score
clarify-requirements
shiyuan17
Use for unresolved product choices or explicit requirements discovery—not discoverable facts, implementation details, approvals, or final goals.
SkillAFreshness: AClaude Code +9 - 0.565score
systematic-debugging
shiyuan17
Use when a specific failure, error, or flaky test needs its root cause proven before fixing—not for applying known fixes.
SkillAFreshness: AClaude Code +9 - 0.564score
define-goal
shiyuan17
Use to write, refine, or activate `/goal` or execution/exploration objectives—not goal status operations.
SkillAFreshness: AClaude Code +9 - 0.564score
frontend-design
shiyuan17
Use for frontend visual direction, polish, responsiveness, or redesign—not logic-only work.
SkillAFreshness: AClaude Code +9
Cite this page
api-and-interface-design skill. Agent Mart. https://agentmart.dev/skills/shiyuan17-api-and-interface-design (last updated 2026-10-24)