cli-creator

Convert API docs and OpenAPI specs into composable command-line tools.

779|80|Updated Jun 20, 2025
One-click install
npx skills add https://github.com/Haohao-end/openagent --skill cli-creator-haohao-end
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-creator
Source: https://github.com/Haohao-end/openagent/tree/main/api/internal/core/skills/catalog/cli-creator
Command: npx skills add https://github.com/Haohao-end/openagent --skill cli-creator-haohao-end

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you turn messy, fragmented source material (API docs, OpenAPI specs, curl examples, SDK notes, or existing scripts) into a durable command-line tool you can run reliably from any working directory.

Core Features & Use Cases

  • Scaffold a real CLI with a stable command contract: designs commands around discovery, ID resolution, read operations, and narrowly-scoped write actions rather than one-off scripts.
  • Produces machine-stable output: supports a consistent --json mode with deterministic success/error shapes suitable for automation.
  • Chooses the lowest-friction runtime: selects Rust, TypeScript/Node, or Python based on what’s installed and the nature of the source material to reduce setup friction.
  • Builds safety and ops into the workflow: includes a doctor command for config/auth validation and recommends dry-run/draft/preview write paths and testable installation on PATH.

Quick Start

Ask an AI to create a composable CLI named ci-logs from my OpenAPI spec, curl examples, and the existing log download script, install it on PATH, implement a --json doctor for auth/config validation, and generate a companion skill that explains when to use ci-logs safely.

Frequently Asked Questions about cli-creator

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

FAQPage Schema
How do I generate a CLI from an OpenAPI spec?

You can generate a CLI from an OpenAPI spec by converting API documentation, curl examples, and SDK notes into a durable command-line tool. This process designs a stable command contract for discovery, ID resolution, and narrowly-scoped write actions.

Can I create a command-line tool with JSON output for automation?

Yes, you can create a command-line tool with machine-stable JSON output for automation. The generated CLI supports a consistent --json mode that provides deterministic success and error shapes suitable for automated workflows.

How do I handle auth and config validation in a generated CLI?

To handle auth and config validation in a generated CLI, the tool includes a doctor command for validating configurations. It manages auth and config precedence safely, ensuring error outputs do not leak credentials during automated operations.

Does the cli-creator work with Python, Node, or Rust runtimes?

The cli-creator works with Python, Node, and Rust runtimes by selecting the lowest-friction option available. It chooses the runtime based on what is installed on your system and the nature of the source API documentation.

What is the best way to turn API documentation into a durable command-line tool?

The best way to turn API documentation into a durable command-line tool is by scaffolding a real CLI with a stable command contract. This approach focuses on paginated reads, narrowly-scoped writes, and testable installation on PATH rather than one-off scripts.