メニュー
Design API contracts before implementation — endpoints, models, status codes (Daniel Okoye's workflow)
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/g-zenr/relay-api --skill design-apiコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
SOC 職業分類に基づく
| name | design-api |
| description | Design API contracts before implementation — endpoints, models, status codes (Daniel Okoye's workflow) |
| disable-model-invocation | true |
Design the API contract for: $ARGUMENTS
Design BEFORE implementing. This produces a specification that /add-endpoint or /add-feature will implement.
For each endpoint, define:
### `METHOD /api/<version>/<path>`
**Summary:** <one-line description>
**Auth:** Required / Public
**Request Body:**
```json
{
"field": "type — description (constraints)"
}
Response 200:
{
"field": "type — description"
}
Error Responses:
| Status | Condition | Response |
|---|---|---|
| 401 | Missing/invalid API key | Uniform auth error message |
| 404 | Resource not found | Error response model |
| 422 | Validation error | Pydantic validation error |
| 503 | External resource unavailable | Error response model |
## Step 3 — Pydantic Models
Define request/response schemas:
```python
class FeatureRequest(BaseModel):
field: type = Field(..., description="...", ge=0)
class FeatureResponse(BaseModel):
field: type
AnyField() — ge, le, min_length, patternProduce a complete API specification document that /add-endpoint or /add-feature can implement directly.