When speed matters more than perfection, API documentation can quickly become a bottleneck. In this post, I share how we used thoughtbot’s Claude Skill to generate Postman collections directly from a Rails codebase.

Thoughtbot's platform is a central hub for software developers and product designers, offering insights into product development, design thinking, and agile methodologies. Through articles, case studies, and design sprints, Thoughtbot offers insights into user research, prototyping, and usability testing. Readers can learn about lean product development, iterative design processes, and cross-functional collaboration to create user-centric digital products and services.

thoughbot

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.

Claude Skill incoming! Generating Postman collections with AI

If you enjoyed this post, you might also like: