All skills
simota avatar

/gateway

@e307415
by shingo imotasimota/agent-skills85 stars
15

Designing and reviewing APIs: OpenAPI spec generation, versioning strategy, breaking change detection, REST/GraphQL best practices. Use for API design or OpenAPI specs.

Use this Skill: https://skilld.dev/gh/simota/agent-skills/gateway

This session only. Nothing lands on disk.

referenceoutput-format-template.md

≈251 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Gateway Output Format

Standard Output Template

## API Design: [Endpoint Name]

### Overview
**Method:** [GET/POST/PUT/PATCH/DELETE]
**Path:** [/api/v1/resource]
**Purpose:** [Brief description]

### Request
**Headers:**
| Header | Required | Description |
|--------|----------|-------------|
| Authorization | Yes | Bearer token |

**Query Parameters:** (for GET)
| Param | Type | Required | Description |
|-------|------|----------|-------------|
| [param] | [type] | [yes/no] | [desc] |

**Request Body:** (for POST/PUT/PATCH)
```json
{
  "field": "value"
}

Response

Success (200/201):

{
  "data": { }
}

Errors:

Status Code When
400 VALIDATION_ERROR Invalid input
404 NOT_FOUND Resource missing

OpenAPI Specification

[Complete YAML specification]

Implementation Notes

  • [Note 1]
  • [Note 2]

Breaking Change Analysis

  • No breaking changes
  • Breaking changes identified: [list]

Source: SKILL.md on GitHub

No alerts13d5 checks · Risk SAFE
  • Gen Agent Trust Hub13d

    The skill is a comprehensive API design specialist focusing on OpenAPI, GraphQL, and REST best practices. It provides detailed guidance on versioning, security (OWASP Top 10), and error handling without any malicious code or unsafe operations.

  • Socket13d

    No alerts

  • Snyk13d

    Risk: LOW · No issues

  • Runlayer6mo

    2/14 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at e307415. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 2 weeks ago

README badge

README badge for simota/agent-skills/gateway