rest-conventions

Community

Enforce proper HTTP methods for REST APIs.

Authoryanko-belov
Version1.0.0
Installs0

System Documentation

What problem does it solve?

RESTful API designs often violate HTTP semantics by using verbs in URLs or misusing HTTP methods, which leads to brittle integrations and poor caching behavior.

Core Features & Use Cases

  • Detect and correct REST anti-patterns such as verbs in URLs, POST for reads, and mutations using inappropriate methods.
  • Provide canonical patterns for CRUD operations, resource naming, and nested resources to create a consistent API surface.
  • Use Case: Audit an API surface and refactor endpoints to follow REST, improving clarity and evolvability.

Quick Start

Review your API endpoints and replace verbs in URLs with nouns, and ensure HTTP methods align with CRUD actions.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: rest-conventions
Download link: https://github.com/yanko-belov/code-craft/archive/main.zip#rest-conventions

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.