api-documentador

Generate layered API documentation for REST, GraphQL, and gRPC APIs.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill api-documentador
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-documentador
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/api-documentador
Command: npx skills add https://github.com/joleques/northstar-ai --skill api-documentador

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation teams waste time stitching multiple docs and fail to meet the needs of diverse audiences. This skill addresses that by generating layered API documentation that serves developers, analysts, support, and product stakeholders.

Core Features & Use Cases

  • Layered outputs: separate technical reference, getting started, use cases, and glossary for different audiences.
  • Context-aware partitioning: supports multiple contexts and domains to keep documentation navigable.
  • Template-driven consistency: enforces authentication, endpoints, models, errors, and versioning across all docs.
  • Use case guidance: assists teams in transforming business goals into actionable documentation workflows.

Quick Start

Ask the AI to generate a complete, multi-layer API documentation package for a given API title and context.

Frequently Asked Questions about api-documentador

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

FAQPage Schema
How do I generate layered API documentation for different audiences?

Layered API documentation is generated by partitioning content into technical references, user guides, and support material to serve developers, analysts, and product teams simultaneously. It enforces templates for authentication, endpoints, models, errors, and versioning to ensure consistency across all generated outputs.

What is the best way to document REST, GraphQL, and gRPC APIs consistently?

Documenting REST, GraphQL, and gRPC APIs consistently requires template-driven generation that enforces standardized sections for authentication, endpoints, models, errors, and versioning. This approach guarantees publish-ready output across diverse protocols while maintaining structural uniformity throughout the technical references.

Can I create separate technical references and getting started guides from a single API?

Creating separate technical references and getting started guides from a single API is achieved through context-aware partitioning. This mechanism divides a single API specification into distinct navigable outputs, including technical references, getting started guides, use cases, and a glossary tailored for different audiences.

How do I structure API documentation templates for authentication and versioning?

Structuring API documentation templates for authentication and versioning involves enforcing standardized sections for endpoints, data models, and errors alongside them. This template-driven consistency ensures all necessary protocol details and structural changes are uniformly documented, resulting in publish-ready output.

Does template-driven API documentation work for multiple domains and contexts?

Template-driven API documentation works for multiple domains and contexts by applying context-aware partitioning to keep navigable content separate. It supports various domains while maintaining consistent templates for authentication, endpoints, models, errors, and versioning across all generated technical and support material.

Why does my API documentation fail to serve developers, analysts, and product teams simultaneously?

API documentation fails to serve developers, analysts, and product teams simultaneously when it lacks layered outputs like technical references, user guides, and glossaries. Without template-driven consistency across endpoints, models, and errors, diverse stakeholders struggle to find relevant, context-aware information within a single document.