[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78294WFY4FX4YN4SEY0BFPJ":3,"skill-same:01M78294WFY4FX4YN4SEY0BFPJ":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M78294WFY4FX4YN4SEY0BFPJ","api-design-patterns",null,"RESTful API design, error handling, versioning, and best practices. Use when designing APIs, reviewing endpoints, implementing error responses, or setting up API structure. Triggers on \"design API\", \"review API\", \"REST best practices\", or \"API patterns\".","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fskills_sh\u002Fs\u002Fskills-sh_asyrafhussin_agent-skills_api-design-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: api-design-patterns\ndescription: RESTful API design, error handling, versioning, and best practices. Use when designing APIs, reviewing endpoints, implementing error responses, or setting up API structure. Triggers on \"design API\", \"review API\", \"REST best practices\", or \"API patterns\".\nlicense: MIT\nmetadata:\n  author: agent-skills\n  version: \"2.0.0\"\n---\n\n# API Design Patterns\n\nRESTful API design principles for building consistent, developer-friendly APIs. Contains 38 rules across 7 categories covering resource design, error handling, security, pagination, versioning, response format, and documentation.\n\n## Metadata\n\n- **Version:** 2.0.0\n- **Rule Count:** 38 rules across 7 categories\n- **License:** MIT\n\n## When to Apply\n\nReference these guidelines when:\n- Designing new API endpoints\n- Reviewing existing API structure\n- Implementing error handling and validation\n- Setting up pagination, filtering, and sorting\n- Planning API versioning strategy\n- Configuring API security (auth, CORS, rate limiting)\n- Writing API documentation (OpenAPI\u002FSwagger)\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Resource Design | CRITICAL | `rest-` |\n| 2 | Error Handling | CRITICAL | `error-` |\n| 3 | Security | CRITICAL | `sec-` |\n| 4 | Pagination & Filtering | HIGH | `page-`, `filter-`, `sort-` |\n| 5 | Versioning | HIGH | `ver-` |\n| 6 | Response Format | MEDIUM | `resp-` |\n| 7 | Documentation | MEDIUM | `doc-` |\n\n## Quick Reference\n\n### 1. Resource Design (CRITICAL)\n\n- `rest-nouns-not-verbs` - Use nouns for endpoints, not verbs\n- `rest-plural-resources` - Use plural resource names\n- `rest-http-methods` - Correct HTTP method usage (GET, POST, PUT, PATCH, DELETE)\n- `rest-nested-resources` - Proper resource nesting (max 2 levels)\n- `rest-status-codes` - Appropriate HTTP status codes\n- `rest-idempotency` - Idempotent operations with idempotency keys\n- `rest-hateoas` - Hypermedia links for discoverability\n- `rest-resource-actions` - Non-CRUD actions as sub-resources\n\n### 2. Error Handling (CRITICAL)\n\n- `error-consistent-format` - Consistent error response structure\n- `error-meaningful-messages` - Helpful, actionable error messages\n- `error-validation-details` - Field-level validation errors\n- `error-error-codes` - Machine-readable error codes\n- `error-no-stack-traces` - Never expose stack traces in production\n- `error-request-id` - Include request IDs for debugging\n\n### 3. Security (CRITICAL)\n\n- `sec-authentication` - Proper auth implementation (OAuth2\u002FJWT)\n- `sec-authorization` - Resource-level permissions (RBAC)\n- `sec-rate-limiting` - Prevent abuse with rate limiting\n- `sec-input-validation` - Validate and sanitize all input\n- `sec-cors-config` - CORS configuration with whitelists\n- `sec-https-only` - Enforce HTTPS for all traffic\n- `sec-sensitive-data` - Protect passwords, tokens, PII\n\n### 4. Pagination & Filtering (HIGH)\n\n- `page-cursor-based` - Cursor pagination for large datasets\n- `page-offset-based` - Offset pagination for simple cases\n- `page-consistent-params` - Consistent parameter naming\n- `page-metadata` - Include pagination metadata in responses\n- `filter-query-params` - Filter via query parameters\n- `sort-flexible` - Flexible sorting with `-` prefix for descending\n\n### 5. Versioning (HIGH)\n\n- `ver-url-path` - Version in URL path (\u002Fapi\u002Fv1\u002F)\n- `ver-header-based` - Version via Accept header\n- `ver-backward-compatible` - Maintain backward compatibility\n- `ver-deprecation` - Deprecation strategy with Sunset header\n\n### 6. Response Format (MEDIUM)\n\n- `resp-consistent-structure` - Consistent response envelope\n- `resp-json-conventions` - JSON naming conventions\n- `resp-partial-responses` - Field selection (sparse fieldsets)\n- `resp-compression` - Response compression (gzip\u002FBrotli)\n\n### 7. Documentation (MEDIUM)\n\n- `doc-openapi` - OpenAPI\u002FSwagger specification\n- `doc-examples` - Request\u002Fresponse examples\n- `doc-changelog` - API changelog\n\n## Essential Guidelines\n\n### Resource Naming\n\n```\n# ❌ Verbs in URLs\nGET    \u002FgetUsers\nPOST   \u002FcreateUser\n\n# ✅ Nouns with HTTP methods\nGET    \u002Fusers          # List users\nPOST   \u002Fusers          # Create user\nGET    \u002Fusers\u002F123      # Get user\nPUT    \u002Fusers\u002F123      # Update user (full)\nPATCH  \u002Fusers\u002F123      # Update user (partial)\nDELETE \u002Fusers\u002F123      # Delete user\n```\n\n### Error Response Format\n\n```json\n{\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"The request contains invalid data\",\n    \"details\": [\n      {\n        \"field\": \"email\",\n        \"code\": \"INVALID_FORMAT\",\n        \"message\": \"Please provide a valid email address\"\n      }\n    ],\n    \"request_id\": \"req_abc123\"\n  }\n}\n```\n\n### Pagination\n\n```json\n{\n  \"data\": [...],\n  \"meta\": {\n    \"current_page\": 2,\n    \"per_page\": 20,\n    \"total_pages\": 10,\n    \"total_count\": 195\n  },\n  \"links\": {\n    \"first\": \"\u002Fusers?page=1&per_page=20\",\n    \"prev\": \"\u002Fusers?page=1&per_page=20\",\n    \"next\": \"\u002Fusers?page=3&per_page=20\",\n    \"last\": \"\u002Fusers?page=10&per_page=20\"\n  }\n}\n```\n\n### Rate Limiting Headers\n\n```\nHTTP\u002F1.1 200 OK\nX-RateLimit-Limit: 1000\nX-RateLimit-Remaining: 998\nX-RateLimit-Reset: 1640995200\n```\n\n## How to Use\n\nRead individual rule files for detailed explanations:\n\n```\nrules\u002Frest-http-methods.md\nrules\u002Ferror-consistent-format.md\nrules\u002Fpage-cursor-based.md\nrules\u002Fsec-authentication.md\nrules\u002Fver-url-path.md\nrules\u002Fdoc-openapi.md\n```\n\n## References\n\n- [RESTful API Guidelines](https:\u002F\u002Frestfulapi.net)\n- [Zalando RESTful API Guidelines](https:\u002F\u002Fzalando.github.io\u002Frestful-api-guidelines)\n- [Microsoft API Guidelines](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fapi-guidelines)\n- [Google API Design Guide](https:\u002F\u002Fcloud.google.com\u002Fapis\u002Fdesign)\n- [OpenAPI Specification](https:\u002F\u002Fswagger.io\u002Fspecification)\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n","# API Design Patterns\n\nRESTful API design principles for building consistent, developer-friendly APIs. Contains 38 rules across 7 categories covering resource design, error handling, security, pagination, versioning, response format, and documentation.\n\n## Metadata\n\n- **Version:** 2.0.0\n- **Rule Count:** 38 rules across 7 categories\n- **License:** MIT\n\n## When to Apply\n\nReference these guidelines when:\n- Designing new API endpoints\n- Reviewing existing API structure\n- Implementing error handling and validation\n- Setting up pagination, filtering, and sorting\n- Planning API versioning strategy\n- Configuring API security (auth, CORS, rate limiting)\n- Writing API documentation (OpenAPI\u002FSwagger)\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix |\n|----------|----------|--------|--------|\n| 1 | Resource Design | CRITICAL | `rest-` |\n| 2 | Error Handling | CRITICAL | `error-` |\n| 3 | Security | CRITICAL | `sec-` |\n| 4 | Pagination & Filtering | HIGH | `page-`, `filter-`, `sort-` |\n| 5 | Versioning | HIGH | `ver-` |\n| 6 | Response Format | MEDIUM | `resp-` |\n| 7 | Documentation | MEDIUM | `doc-` |\n\n## Quick Reference\n\n### 1. Resource Design (CRITICAL)\n\n- `rest-nouns-not-verbs` - Use nouns for endpoints, not verbs\n- `rest-plural-resources` - Use plural resource names\n- `rest-http-methods` - Correct HTTP method usage (GET, POST, PUT, PATCH, DELETE)\n- `rest-nested-resources` - Proper resource nesting (max 2 levels)\n- `rest-status-codes` - Appropriate HTTP status codes\n- `rest-idempotency` - Idempotent operations with idempotency keys\n- `rest-hateoas` - Hypermedia links for discoverability\n- `rest-resource-actions` - Non-CRUD actions as sub-resources\n\n### 2. Error Handling (CRITICAL)\n\n- `error-consistent-format` - Consistent error response structure\n- `error-meaningful-messages` - Helpful, actionable error messages\n- `error-validation-details` - Field-level validation errors\n- `error-error-codes` - Machine-readable error codes\n- `error-no-stack-traces` - Never expose stack traces in production\n- `error-request-id` - Include request IDs for debugging\n\n### 3. Security (CRITICAL)\n\n- `sec-authentication` - Proper auth implementation (OAuth2\u002FJWT)\n- `sec-authorization` - Resource-level permissions (RBAC)\n- `sec-rate-limiting` - Prevent abuse with rate limiting\n- `sec-input-validation` - Validate and sanitize all input\n- `sec-cors-config` - CORS configuration with whitelists\n- `sec-https-only` - Enforce HTTPS for all traffic\n- `sec-sensitive-data` - Protect passwords, tokens, PII\n\n### 4. Pagination & Filtering (HIGH)\n\n- `page-cursor-based` - Cursor pagination for large datasets\n- `page-offset-based` - Offset pagination for simple cases\n- `page-consistent-params` - Consistent parameter naming\n- `page-metadata` - Include pagination metadata in responses\n- `filter-query-params` - Filter via query parameters\n- `sort-flexible` - Flexible sorting with `-` prefix for descending\n\n### 5. Versioning (HIGH)\n\n- `ver-url-path` - Version in URL path (\u002Fapi\u002Fv1\u002F)\n- `ver-header-based` - Version via Accept header\n- `ver-backward-compatible` - Maintain backward compatibility\n- `ver-deprecation` - Deprecation strategy with Sunset header\n\n### 6. Response Format (MEDIUM)\n\n- `resp-consistent-structure` - Consistent response envelope\n- `resp-json-conventions` - JSON naming conventions\n- `resp-partial-responses` - Field selection (sparse fieldsets)\n- `resp-compression` - Response compression (gzip\u002FBrotli)\n\n### 7. Documentation (MEDIUM)\n\n- `doc-openapi` - OpenAPI\u002FSwagger specification\n- `doc-examples` - Request\u002Fresponse examples\n- `doc-changelog` - API changelog\n\n## Essential Guidelines\n\n### Resource Naming\n\n```\n# ❌ Verbs in URLs\nGET    \u002FgetUsers\nPOST   \u002FcreateUser\n\n# ✅ Nouns with HTTP methods\nGET    \u002Fusers          # List users\nPOST   \u002Fusers          # Create user\nGET    \u002Fusers\u002F123      # Get user\nPUT    \u002Fusers\u002F123      # Update user (full)\nPATCH  \u002Fusers\u002F123      # Update user (partial)\nDELETE \u002Fusers\u002F123      # Delete user\n```\n\n### Error Response Format\n\n```json\n{\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"The request contains invalid data\",\n    \"details\": [\n      {\n        \"field\": \"email\",\n        \"code\": \"INVALID_FORMAT\",\n        \"message\": \"Please provide a valid email address\"\n      }\n    ],\n    \"request_id\": \"req_abc123\"\n  }\n}\n```\n\n### Pagination\n\n```json\n{\n  \"data\": [...],\n  \"meta\": {\n    \"current_page\": 2,\n    \"per_page\": 20,\n    \"total_pages\": 10,\n    \"total_count\": 195\n  },\n  \"links\": {\n    \"first\": \"\u002Fusers?page=1&per_page=20\",\n    \"prev\": \"\u002Fusers?page=1&per_page=20\",\n    \"next\": \"\u002Fusers?page=3&per_page=20\",\n    \"last\": \"\u002Fusers?page=10&per_page=20\"\n  }\n}\n```\n\n### Rate Limiting Headers\n\n```\nHTTP\u002F1.1 200 OK\nX-RateLimit-Limit: 1000\nX-RateLimit-Remaining: 998\nX-RateLimit-Reset: 1640995200\n```\n\n## How to Use\n\nRead individual rule files for detailed explanations:\n\n```\nrules\u002Frest-http-methods.md\nrules\u002Ferror-consistent-format.md\nrules\u002Fpage-cursor-based.md\nrules\u002Fsec-authentication.md\nrules\u002Fver-url-path.md\nrules\u002Fdoc-openapi.md\n```\n\n## References\n\n- [RESTful API Guidelines](https:\u002F\u002Frestfulapi.net)\n- [Zalando RESTful API Guidelines](https:\u002F\u002Fzalando.github.io\u002Frestful-api-guidelines)\n- [Microsoft API Guidelines](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fapi-guidelines)\n- [Google API Design Guide](https:\u002F\u002Fcloud.google.com\u002Fapis\u002Fdesign)\n- [OpenAPI Specification](https:\u002F\u002Fswagger.io\u002Fspecification)\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded: `AGENTS.md`\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"agent-skills","2.0.0","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fskills_sh\u002Fs\u002Fskills-sh_asyrafhussin_agent-skills_api-design-patterns",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill api-design-patterns",{"tool":42,"command":43},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill api-design-patterns",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill api-design-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fskills_sh\u002Fs\u002Fskills-sh_asyrafhussin_agent-skills_api-design-patterns\u002FSKILL.md",true,[],[51,58,65,72,79,86],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]