incur

Develop type-safe, agent-friendly CLIs using TypeScript and Zod schemas.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/0xBigBoss/incur --skill incur-0xbigboss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: incur
Source: https://github.com/0xBigBoss/incur/tree/main
Command: npx skills add https://github.com/0xBigBoss/incur --skill incur-0xbigboss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk, @readme/openapi-parser, @toon-format/toon, tokenx, yaml, zod, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the creation of command-line interfaces (CLIs) that are robust, type-safe, and easily discoverable by AI agents, eliminating the need for complex configuration or manual tool definition.

Core Features & Use Cases

  • Agent Discovery: Automatically registers CLIs with AI agents via MCP or Skill files.
  • Token Efficiency: Reduces token usage in AI interactions through optimized output formats (TOON) and on-demand skill loading.
  • Type Safety: Ensures robust I/O through Zod schemas for arguments, options, and output, providing strong type inference for agents.
  • Use Case: Develop a new CLI tool for managing cloud infrastructure. The Skill handles argument parsing, help text generation, agent integration, and provides a clear API for defining commands and their behavior.

Quick Start

Use the incur skill to create a new CLI named 'my-cli' that greets the user.

Frequently Asked Questions about incur

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

FAQPage Schema
How do I build a type-safe CLI for AI agents using TypeScript?

Build a type-safe CLI for AI agents using TypeScript by defining commands with Zod schemas for arguments and options. This approach provides strong type inference and automatic agent discovery, eliminating manual tool configuration.

How can I make my CLI automatically discoverable by AI agents?

Make your CLI discoverable by AI agents through automatic registration via MCP or Skill files. This eliminates the need for complex configuration or manual tool definition, allowing agents to seamlessly integrate with your command workflows.

What is the best way to reduce token usage when AI agents interact with my CLI?

Reduce token usage in AI interactions by utilizing optimized output formats like TOON and implementing on-demand skill loading. This token-efficient approach minimizes the context overhead required for agent communication.

Does this CLI development approach support middleware and Zod schema validation?

Yes, this CLI development approach supports both middleware and Zod schema validation. It ensures robust I/O by using Zod schemas for arguments, options, and output, while middleware allows you to intercept and modify command execution workflows.

How do I create a new command-line interface for managing cloud infrastructure that integrates with AI workflows?

Create a new command-line interface for managing cloud infrastructure by defining commands and their behavior through a clear API. The tool handles argument parsing, help text generation, and agent integration, providing a seamless AI workflow experience.

Can I use OpenAPI specifications to generate commands for an agent-friendly CLI?

Yes, you can use OpenAPI specifications to generate commands for an agent-friendly CLI. The tool leverages the @readme/openapi-parser dependency to parse specifications, enabling type-safe command generation directly from your API definitions.