doc-api-md

Generate structured Markdown API documentation from predefined templates.

1|Updated Feb 8, 2024
One-click install
npx skills add https://github.com/hokix/dotfiles --skill doc-api-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-api-md
Source: https://github.com/hokix/dotfiles/tree/main/ai/.agents/skills/doc-api-md
Command: npx skills add https://github.com/hokix/dotfiles --skill doc-api-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill streamlines the creation of API documentation by providing standardized Markdown templates for both client-facing (toC) and server-to-server APIs.

Core Features & Use Cases

  • Standardized Templates: Generates documentation using predefined structures for domains, endpoints, request/response schemas, and authentication.
  • API Type Support: Differentiates between toC (mobile/web) and server interfaces.
  • Use Case: A developer needs to document a new REST API endpoint. They provide the endpoint details, and the Skill generates a well-formatted Markdown document ready for inclusion in a project's documentation.

Quick Start

Use the doc-api-md skill to generate documentation for a new toC API endpoint.

Frequently Asked Questions about doc-api-md

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

FAQPage Schema
How do I generate API documentation in Markdown format?

To generate API documentation in Markdown, you provide endpoint details, schemas, and authentication info to produce structured documents using predefined templates for domains and contacts.

What's the best way to document a REST API for both mobile and server interfaces?

Documenting a REST API for both mobile and server interfaces is handled by generating standardized Markdown using separate predefined templates specifically designed for toC and server-to-server APIs.

Can I define request and response schemas when creating an API specification in Markdown?

You can define request and response schemas when creating an API specification, as the generation process structures domains, endpoints, authentication, and contact information into the Markdown output.

Does this Markdown generator support different templates for toC and server APIs?

This Markdown generator supports different templates for toC and server APIs, utilizing specific assets like toc_template.md and server_template.md to ensure structured output for each interface type.

What do I need to provide to generate a structured REST API document?

To generate a structured REST API document, you need to provide endpoint details, domain definitions, request and response schemas, authentication methods, and contact information for the template processing.