SkillsAdd

smithery.ai

create-rest-api

Creates a REST API endpoint that adheres to the architectural, coding, testing, and security rules defined in agents.md. Orchestrates API design, validation, service logic, persistence access, and test generation.

First seen Apr 17, 2026

Installation

$ npx skills add https://smithery.ai
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

remotion-create Similar name
remotion-dev/skills

Create a new Remotion video

74.5K installs
create-auth Similar name
better-auth/skills 29.9K installs
recipe-create-presentation Similar name
googleworkspace/cli

Create a new Google Slides presentation and add initial slides.

29.3K installs
recipe-create-gmail-filter Similar name
googleworkspace/cli

Create a Gmail filter to automatically label, star, or categorize incoming messages.

28.3K installs
recipe-create-doc-from-template Similar name
googleworkspace/cli

Copy a Google Docs template, fill in content, and share with collaborators.

27.7K installs
recipe-create-shared-drive Similar name
googleworkspace/cli

Create a Google Shared Drive and add members with appropriate roles.

27.3K installs

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai
smithery-ai-cli 7.8K frontend-design 6.2K skill-creator 2.5K ck:ui-ux-pro-max 1.3K pdf 1.2K xlsx 966 pptx 894 docx 884 webapp-testing 1 web-design-reviewer 657

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,457 B
  • docs SUMMARY.md 236 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Skill: Create REST API Endpoint

Purpose

Create a REST API endpoint while strictly following the constraints and conventions defined in agents.md.

When to Use

  • Adding a new REST endpoint
  • Extending an existing API with new functionality

Do not use this skill for:

  • UI-only changes
  • Internal refactoring without API impact

Inputs

  • Endpoint intent
  • HTTP method
  • Resource name
  • Request parameters or body
  • Expected success and failure responses

Outputs

  • Controller endpoint
  • Service-layer logic
  • DAO integration (if required)
  • Unit tests
  • Updated documentation (if applicable)

Governing Rules

This skill must comply with all relevant sections of agents.md. If a conflict exists, agents.md takes precedence.

Composed Skills

Executed in order:

  1. api-design/SKILL.md
  2. validation/SKILL.md
  3. service-logic/SKILL.md
  4. dao-access/SKILL.md
  5. test-generation/SKILL.md

Pre-Implementation Checklist

REQUIRED: Before any implementation, complete these steps:

  • Read api-design/SKILL.md - Understand API design patterns and contract definition
  • Read validation/SKILL.md - Learn validation strategies and error handling
  • Read service-logic/SKILL.md - Review service layer implementation patterns
  • Read dao-access/SKILL.md - Understand persistence and data access patterns
  • Read test-generation/SKILL.md - Learn test generation guidelines and coverage expectations

Agent must acknowledge completion of all reads before proceeding with implementation.

Procedure

  1. Clarify requirements and assumptions
  2. Design API contract
  3. Validate inputs
  4. Implement service logic
  5. Integrate persistence if required
  6. Add unit tests
  7. Review against agents.md
  8. Surface risks and trade-offs

References

  • references/rest-api.md
  • references/testing.md

Script References

  • scripts/build.sh

Failure Handling

  • Stop on unclear requirements
  • Stop on architectural violations
  • Escalate security or design concerns
  • Do not auto-fix ambiguous behavior

Review Notes

Document:

  • Assumptions
  • Trade-offs
  • Follow-ups