Build or update the BlueBubbles external channel plugin for Moltbot (extension package, REST...
api-design
1
1
# Install this skill:
npx skills add mpadmaraj/sample-agentic --skill "api-design"
Install specific skill from multi-skill repository
# Description
>
# SKILL.md
name: api-design
description: >
Designs a REST API contract that aligns with architectural,
naming, and interface rules defined in agents.md.
Skill: API Design
Purpose
Define a clear and consistent REST API contract before implementation.
When to Use
- Creating a new API endpoint
- Modifying an existing API contract
Inputs
- Resource name
- Operation intent
- HTTP method
- Request parameters or body
- Expected responses
Outputs
- Endpoint path
- HTTP method
- Request model
- Response model
- Error scenarios
Governing Rules
All API design decisions must comply with agents.md,
especially sections on Architecture and API Design.
Procedure
- Identify the primary resource
- Select the appropriate HTTP method
- Define request and response structure
- Identify error cases
- Validate design against
agents.md
Failure Handling
- Stop if API semantics are unclear
- Stop if design leaks internal details
- Escalate ambiguous contracts
# Related Skills
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Manage Trello boards, lists, and cards via the Trello REST API.
Add a new endpoint or endpoints to Ghost's Admin API at `ghost/api/admin/**`.
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Amp
Antigravity
Claude Code
Clawdbot
Codex
Cursor
Droid
Gemini CLI
GitHub Copilot
Goose
Kilo Code
Kiro CLI
OpenCode
Roo Code
Trae
Windsurf
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.