rc-postman

Generates and syncs Postman v2.1.0 collections and environment files from source code HTTP endpoints.

19|1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/rodolfochicone/rc-project --skill rc-postman-rodolfochicone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rc-postman
Source: https://github.com/rodolfochicone/rc-project/tree/main/skills/misc/rc-postman
Command: npx skills add https://github.com/rodolfochicone/rc-project --skill rc-postman-rodolfochicone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a Postman collection in sync with an evolving API is tedious manual work: routes change, request schemas drift, and the collection silently goes stale. This Skill discovers HTTP endpoints and their request contracts directly from source code and builds or updates the collection and environment files automatically. ## Core Features & Use Cases - Endpoint Discovery: Detects routing across frameworks (Express, Fastify, NestJS, Gin, Spring, FastAPI, Rails, ASP.NET) and infrastructure manifests (serverless.yml, API Gateway), excluding non-HTTP triggers like queues and cron jobs. - Request Contract Extraction: Reads validation schemas and DTOs (Zod, Joi, Pydantic, class-validator, Go structs) to build accurate path params, query params, headers, and example JSON bodies with type-appropriate values. - Collection & Environment Sync: Emits a Postman Collection Format v2.1.0 file grouped by resource folders plus per-environment JSON files using {{baseUrl}} variables, then reports added, updated, and removed endpoints. - Use Case: After refactoring your Express API routes and Zod schemas, run this Skill to regenerate the collection so your team always tests against the real request contracts. ## Quick Start Ask the agent to generate or update a Postman collection from this repository's HTTP endpoints and save it with a Local environment file.

Frequently Asked Questions about rc-postman

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Postman collection from my API source code?▼

Run this Skill against the repository: it detects your routing framework, enumerates every HTTP endpoint with method and path, extracts request contracts from validation schemas, and writes a Postman v2.1.0 collection plus environment files to the output directory.

How to keep a Postman collection in sync after routes change?▼

Re-run the Skill after modifying routes or request schemas. It adds new endpoints to the appropriate folder, updates changed requests, removes requests whose endpoints no longer exist in source, and reports the full diff of changes.

Which frameworks are supported for endpoint discovery?▼

Discovery covers Express, Fastify, NestJS, Gin, Echo, Spring controllers, FastAPI, Flask, Rails routes, and ASP.NET controllers, plus infrastructure manifests like serverless.yml and API Gateway definitions. Non-HTTP triggers such as queues and cron jobs are excluded.

Does it modify my source code when building the collection?▼

No. The Skill only reads source code to discover endpoints and schemas; it writes exclusively the collection and environment JSON files. If a handler's schema cannot be located, it flags the body as incomplete rather than fabricating fields.

When should I use OpenAPI generation instead of a Postman collection?▼

Use OpenAPI generation (rc-openapi) when you need a formal API specification for documentation portals or contract testing. Use this Skill when the goal is an executable Postman collection with environment files for manual or automated API testing.