api-documentation

Generate and update API specifications in Notion and Postman.

2|Updated Feb 27, 2026

Search Tags:#developer tools #documentation #api #specification #notion #postman

Ready to run

npx skills add https://github.com/onejaejae/skills --skill api-documentation-onejaejae

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: api-documentation
Source: https://github.com/onejaejae/skills/tree/main/plugins/ai-registry/common/workflow-bundle/skills/api-documentation
Command: npx skills add https://github.com/onejaejae/skills --skill api-documentation-onejaejae

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of documenting APIs, ensuring consistency and accuracy across Notion and Postman.

Core Features & Use Cases

API Specification Generation: Create draft API documentation pages in Notion.
Real-time Updates: Finalize API specifications in Notion and update Postman collections with request details and response examples.
Use Case: When developing a new API endpoint, use this Skill in Phase 2 to generate a draft Notion page and in Phase 6 to update it with the finalized request/response schemas after implementation.

Quick Start

Use the api-documentation skill to draft a new API page for a POST request to /api/v1/users.

Frequently Asked Questions about api-documentation

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

FAQPage Schema

How do I automate API documentation generation in Notion and Postman?▼

Automating API documentation generates draft specifications in Notion and updates Postman collections with request details. It creates pages based on task definitions and finalizes them with implementation details like response schemas.

What is the best way to keep API specifications up to date throughout the development lifecycle?▼

Keeping API specifications up to date involves finalizing Notion pages and updating Postman collections after implementation. This ensures documentation reflects actual request bodies and response schemas throughout development.

How do I create a draft API documentation page in Notion for a new endpoint?▼

Creating a draft API documentation page in Notion starts by providing a task definition for the endpoint. The skill generates a draft page that you later finalize with implementation details and response examples.

Can I update Postman collections with request bodies and response schemas automatically?▼

Updating Postman collections automatically adds request bodies and response schemas to your existing setup. It finalizes the API specifications by syncing implementation details directly into your Postman environment.

Does this API documentation approach work for both draft creation and finalization phases?▼

This API documentation approach works for both draft creation and finalization phases. It generates draft Notion pages during early phases and updates them with finalized request and response schemas after implementation.