Restful Hateoas

This is a comprehensive reference for building Richardson Level 3 REST APIs in Rails, covering everything from resource modeling and HTTP semantics to hypermedia controls and API evolution. It includes 47 rules organized by request/response lifecycle, so you can look up proper link relations, caching headers, or pagination patterns when designing endpoints. The rules are prioritized by impact, which helps when you're under time pressure and need to know what actually matters versus what's nice to have. If you're tired of ad-hoc REST decisions or arguing with your team about whether to use PUT or PATCH, this gives you concrete patterns backed by IETF specs and IANA registries. The focus on hypermedia and content negotiation makes it most useful for mature APIs where evolvability matters.

skills.sh installs: 298
GitHub stars: 222
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pproenca/dot-skills --skill restful-hateoas --agent claude-code

Installs into .claude/skills of the current project.

Files

Community RESTful HATEOAS Best Practices

Comprehensive guide to building REST APIs that reach the Glory of REST (Richardson Maturity Level 3) in Ruby on Rails. Contains 47 rules across 9 categories, ordered by the request/response lifecycle — from resource URI design through hypermedia link relations to API evolution.