A thoughtbot consultant working on a fast-paced crypto startup shares how they built and used a Claude Skill to auto-generate Postman collections from Rails controllers. The tool scans controllers, routes, parameters, and RSpec request specs to produce a ready-to-use Postman collection JSON, solving the problem of keeping API docs current without heavy maintenance overhead. Key details include how the skill was iteratively improved (e.g., diffing against main branch instead of scanning all controllers), its limitations around LLM accuracy, and how it can be integrated into CI. The project is open source on GitHub.

4m read timeFrom thoughtbot.com
Post cover image
Table of contents
Shipping API Docs Under PressureWhat is a Claude Skill?How it worksLimitationsFinal thoughtsIf you enjoyed this post, you might also like:

Sort: