Does it support custom Notion database properties?

Yes, it is pre-configured to map specific fields like Endpoint, Method, and Version to a standardized Notion API Mapping database schema (ID: 2d3471f8-dcff-8017-8f2c-f3db7658c869).

How does it handle error messages compared to standard Swagger?

Unlike basic tools that only read the spec, this skill analyzes your actual source code (controllers and services) to find throw statements and error enums, ensuring documentation reflects the real implementation.

Does this skill require a specific Swagger format?

It requires a standard api-docs.json snapshot, which should be pre-generated in the /tmp/bitda-swagger-snapshot/ directory, typically using a companion swagger-snapshot skill.

Can I bulk upload all my APIs at once?

No, to ensure accuracy and prevent database clutter, the skill requires you to specify the API or Controller you want to document, such as 'WarehouseController' or a specific GET endpoint.

API to Notion Documentation

Name: API to Notion Documentation
Author: invigoworks

byinvigoworks

0•

API 开发

Automates the creation and maintenance of detailed API documentation in Notion by analyzing Swagger snapshots and source code.

This skill streamlines the backend documentation process by bridging the gap between your codebase and Notion. It parses Swagger api-docs.json files and performs deep static analysis of your source code to extract endpoint details, authentication requirements, request/response schemas, and actual error responses from throw statements. By enforcing strict formatting rules, specialized nested object representations, and automatic versioning, it ensures your Notion API mapping database remains an accurate, production-grade source of truth without manual data entry.

主要功能

01Support for complex nested DTOs and LabeledEnum mappings using parent.child notation.

02Automatic extraction of security roles and permissions from @PreAuthorize annotations.

03Deep codebase analysis to extract real-world error codes and exception data from throw statements.

04Automated Notion database item creation with structured API metadata and versioning.

050 GitHub stars

06Strict formatting enforcement using Notion native blocks and code-styled parameter lists.

使用场景

01Maintaining an up-to-date API registry with consistent versioning and change history tracking.

02Syncing new backend endpoints to a centralized Notion team workspace with zero manual typing.

03Documenting detailed validation rules and error response structures directly from Java/Spring DTOs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add invigoworks/invigo-marketplace api-to-notion

For use in Claude.ai and ChatGPT

Download Skill