cli-craft

Design, implement, and review CLI tools with compliance auditing.

6|1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/outfitter-dev/outfitter --skill cli-craft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cli-craft
Source: https://github.com/outfitter-dev/outfitter/tree/main/plugins/fieldguides/skills/cli-craft
Command: npx skills add https://github.com/outfitter-dev/outfitter --skill cli-craft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) and templates (resource) components.

What problem does it solve?

This Skill addresses the challenges of designing, implementing, and reviewing command-line interface (CLI) tools to ensure they are user-friendly, composable, and adhere to best practices.

Core Features & Use Cases

  • CLI Contract Design: Defines commands, flags, input/output behavior, exit codes, and configuration.
  • Implementation Guidance: Provides patterns for safe defaults, error handling, and scripting-friendliness.
  • Compliance Auditing: Includes a script (cli_audit.py) to automatically check CLI adherence to conventions.
  • Use Case: When designing a new CLI tool, use this Skill to ensure it follows established conventions for help messages, argument parsing, and output streams, making it intuitive for users and easy to integrate into automated workflows.

Quick Start

Use the cli-craft skill to design a new CLI tool for managing user profiles.

Frequently Asked Questions about cli-craft

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

FAQPage Schema
What are the best practices for designing a user-friendly command-line interface?

Best practices for designing a user-friendly command-line interface involve adhering to human-first UX, ensuring UNIX composability, and following conventions for discoverable help, argument parsing, and stdout/stderr separation. These guidelines make CLI tools intuitive and easy to integrate into automated workflows.

How do I ensure my CLI tool follows standard exit codes and output stream conventions?

You ensure your CLI tool follows standard exit codes and output stream conventions by applying established design patterns for safe defaults and error handling, separating stdout from stderr, and running an automated audit script to check compliance with UNIX composability standards.

How do I audit an existing CLI for adherence to scripting and UX conventions?

You audit an existing CLI for adherence to scripting and UX conventions by running the included `cli_audit.py` script, which automatically checks your command-line tool's compliance with help message formats, exit codes, and output stream behaviors.

Do I need Python to use the cli-craft guidelines and audit scripts?

Yes, you need Python3 installed in your environment to run the included automated audit script and utilize the templates provided for implementing and reviewing your command-line interface design.

What is UNIX composability and why does it matter for command-line tools?

UNIX composability is the principle of designing command-line tools to work together through standard input and output streams. It matters for CLIs because it enables seamless integration into automated workflows and scripting pipelines, ensuring robust and predictable execution.