Skills
.Work. You
Rest

governing-http-semantics

Official

Enforce HTTP method and status code standards.

Software Engineering#api design#http#idempotency#status codes#rfc 9110#rest semantics#method safety
Authormusher-dev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill ensures that your APIs adhere to fundamental HTTP principles (RFC 9110), preventing common issues like side effects on GET requests, incorrect status code usage, and ambiguous method semantics, leading to more predictable and reliable web services.

Core Features & Use Cases

  • Method Safety Enforcement: Audits GET and HEAD requests to ensure they are side-effect free.
  • Idempotency Guarantees: Verifies that PUT and DELETE operations are idempotent.
  • Status Code Precision: Guides the correct use of success (2xx) and error (4xx, 5xx) codes, distinguishing between similar codes like 201/202 and 401/403.
  • Content-Type Negotiation: Ensures proper handling of request and response content types.
  • Use Case: Reviewing an API endpoint that uses GET /users/{id}/delete to remove a user. This skill would flag it as a violation of method safety and recommend changing it to DELETE /users/{id}.

Quick Start

Use the governing-http-semantics skill to audit the HTTP method usage in the file '/api/users'.

Dependency Matrix

Required Modules

None required

Components

references

💻 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: governing-http-semantics
Download link: https://github.com/musher-dev/bundles/archive/main.zip#governing-http-semantics

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.