Skills
.Work. You
Rest

governing-mutation-semantics

Official

Enforce consistent API mutation rules.

Software Engineering#api#patch#mutation#put#json merge patch#rfc 7396#array mutation
Authormusher-dev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill standardizes how APIs handle updates (PUT and PATCH) and array modifications, preventing common bugs and ensuring predictable client-server interactions.

Core Features & Use Cases

  • Standardized PUT: Ensures PUT requests perform full resource replacement, resetting omitted optional fields.
  • JSON Merge Patch for PATCH: Enforces RFC 7396 for partial updates, simplifying client implementation and server logic.
  • Safe Array Mutation: Mandates dedicated sub-resource endpoints for array modifications, avoiding race conditions and complexity.
  • Use Case: Reviewing a new API endpoint to ensure its PUT and PATCH methods adhere to best practices, or auditing existing endpoints for consistency in handling array updates.

Quick Start

Use the governing-mutation-semantics skill to audit the PUT and PATCH implementation for the /users/{id} endpoint.

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