القائمة
Use when designing, reviewing, or evolving API contracts. Provides OpenAPI templates, breaking-change checklists, versioning decision trees, and governance checklists.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when designing Copilot agents, authoring agent definitions, creating skill folders, or scaffolding instruction files. Provides templates and conventions for the agent ecosystem.
API authentication, authorization, input validation, rate limiting, and protection patterns
Scan legacy applications to discover project structure, NuGet/npm dependencies, database connection strings, external service bindings, framework versions, and migration complexity scores. Produces structured JSON, YAML, or Markdown inventory reports.
Use when designing systems, recording architecture decisions, evaluating technologies, or assessing architectural risks. Provides C4 diagram templates, ADR format, technology selection matrices, and risk registers.
Deploy, scale, and manage containerized applications on Azure Container Apps with Dapr, revision management, and advanced networking
Azure DevOps REST API patterns — authentication, scopes, pagination, throttling, and endpoint taxonomy for work items, pipelines, repos, and artifacts.
| name | api-design |
| description | Use when designing, reviewing, or evolving API contracts. Provides OpenAPI templates, breaking-change checklists, versioning decision trees, and governance checklists. |
| compatibility | ["VS Code","Cursor","Windsurf","Claude Code"] |
| metadata | {"category":"Uncategorized","tags":["uncategorized"],"maturity":"beta","audience":["developers"]} |
| allowed-tools | ["bash","git","grep","find"] |
Use this skill when the task involves designing new API contracts, reviewing spec changes for breaking changes, choosing a versioning strategy, or enforcing API governance standards.
Reference this skill by attaching skills/api-design/SKILL.md to your agent context, or instruct the agent:
Use the api-design skill. Apply the OpenAPI template, breaking-change checklist, and governance checklist to the API being designed.
| Template | Purpose |
|---|---|
openapi-template.md | OpenAPI 3.x skeleton for a new REST API resource with full CRUD, pagination, and error envelopes |
breaking-change-checklist.md | Checklist for evaluating whether a spec change is breaking, with mitigation guidance |
versioning-decision-tree.md | Decision tree for choosing the right versioning action for a given change |
api-governance-checklist.md | Governance checklist that every API spec must pass before approval |
This skill is designed to be used alongside the api-designer agent. The agent drives the workflow; this skill provides the reference templates and standards.
For implementation after design, hand off to the backend-dev agent. For data model design, coordinate with the data-tier agent. For consumer integration, share the spec with the frontend-dev agent.
