api-spec

Retrieve API specifications with schemas, curl examples, and code snippets.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/jaturapornchai/bcaicloudskill --skill api-spec-jaturapornchai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-spec
Source: https://github.com/jaturapornchai/bcaicloudskill/tree/main/skills/api-spec
Command: npx skills add https://github.com/jaturapornchai/bcaicloudskill --skill api-spec-jaturapornchai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps you understand exactly what data an API endpoint expects and what it will return, eliminating guesswork and reducing integration errors.

Core Features & Use Cases

  • View API Specifications: Get detailed request and response schemas for any given API path.
  • Generate Code Snippets: Obtain ready-to-use code examples in various languages (Dart, TypeScript, Go).
  • See Example Payloads: Understand how to structure requests and interpret responses with practical examples.
  • Use Case: Before calling a new /users/{id} endpoint, use /api-spec users/{id} to see the required path parameters, the JSON body structure for updating a user, and an example of the response, including authentication tokens.

Quick Start

Use the api-spec skill to view the specification for the login endpoint.

Frequently Asked Questions about api-spec

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

FAQPage Schema
How do I view API specifications for a specific endpoint?

To view API specifications, provide the endpoint path to retrieve detailed request and response schemas, including path parameters, JSON body structures, and example payloads for that endpoint.

Can I generate code snippets for API requests in Dart or TypeScript?

Yes, you can generate ready-to-use code snippets for API requests in languages like Dart, TypeScript, and Go, providing concrete usage examples to facilitate rapid development and integration.

How are internal $ref pointers resolved when exploring an API schema?

Internal $ref pointers are automatically resolved to fully detail model structures, ensuring you see the complete request and response schemas without manually cross-referencing separate model definitions.

Does this tool provide curl examples for API endpoints?

Yes, the tool retrieves and displays curl examples alongside detailed API specifications for specified endpoints, helping you understand exactly what data the API expects and returns.

What is the best way to understand API contracts before integrating a new endpoint?

The best way to understand API contracts is to retrieve the endpoint specification to see required parameters, JSON body structures, and example responses, eliminating guesswork and reducing integration errors.