Communitygithub.com

Anmolop97/Agent-Skills

掌握 REST 和 GraphQL API 设计原则,构建直观、可扩展且易于维护的 API,使开发者满意。在设计新 API、审查 API 规范或建立 API 设计标准时使用。

Agent-Skills 是什么?

此技能旨在帮助开发者掌握 REST 和 GraphQL API 的核心设计原则,从而构建出直观、可扩展且易于维护的 API。它适用于设计新 API、重构现有 API、为团队建立 API 设计标准,或在实施前审查 API 规范等场景。该技能提供了结构化的设计流程,包括定义消费者和用例、选择 API 风格、建模资源、指定错误处理、版本控制、分页和认证策略,并通过示例进行验证。它还引用了详细的实现手册(`resources/implementation-playbook.md`),其中包含模式、检查清单和模板,以支持更深入的实践。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anmolop97/Agent-Skills/tree/HEAD/skills/api-design-principles

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

API 设计原则

掌握 REST 和 GraphQL API 设计原则,构建直观、可扩展且易于维护的 API,以取悦开发者并经受住时间的考验。

使用此技能的场景

  • 设计新的 REST 或 GraphQL API
  • 重构现有 API 以提高可用性
  • 为团队建立 API 设计标准
  • 在实施前审查 API 规范
  • 在 API 范式之间迁移 (REST 到 GraphQL 等)
  • 创建对开发者友好的 API 文档
  • 针对特定用例(移动端、第三方集成)优化 API

不使用此技能的场景

  • 你只需要针对特定框架的实现指导
  • 你只进行基础设施相关工作,不涉及 API 合约
  • 你无法更改或版本化公共接口

操作指令

  1. 定义消费者、用例和约束。
  2. 选择 API 风格并建模资源或类型。
  3. 指定错误、版本控制、分页和认证策略。
  4. 通过示例进行验证并审查一致性。

有关详细模式、检查清单和模板,请参考 resources/implementation-playbook.md。

资源

  • resources/implementation-playbook.md:包含详细模式、检查清单和模板。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Anmolop97/Agent-Skills

Searches, installs, updates, and lists skills from the Antigravity Skill Vault. Use when choosing or managing workspace or global skills through the npm CLI.

Anmolop97/Agent-Skills

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

Anmolop97/Agent-Skills

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

Anmolop97/Agent-Skills

Searches, installs, updates, and lists skills from the Antigravity Skill Vault. Use when choosing or managing workspace or global skills through the npm CLI.

相关技能