This one's for when you're building CLI tools and want to avoid the usual mess of blocking I/O and hardcoded ANSI codes. It pushes async-first design throughout (all file ops, network calls, everything), recommends specific frameworks like stricli for TypeScript and cyclopts for Python, and has strong opinions on output formatting: unicode symbols over emojis, proper color libraries that respect NO_COLOR, and composable command patterns using the strategy pattern for workflow branching. The framework recommendations are opinionated but practical, focusing on modern async support rather than just picking the most popular options. Good if you're starting fresh or refactoring a CLI that's become a tangled mess of callbacks.

skills.sh installs
201
GitHub stars
22
last updated
Aug 21, 2026

Install

$ npx -y skills add siviter-xyz/dot-agent --skill cli-building --agent claude-code

Installs into .claude/skills of the current project.

Files

CLI Building

Guidelines for building command-line interfaces with modern patterns and best practices.

When to Use

  • Creating new CLI tools or commands
  • Building interactive terminal applications
  • Adding commands to existing projects
  • Implementing command-line interfaces
  • Working with CLI frameworks

Core Principles

  • Async-first: All I/O operations should be async/await, avoid blocking operations
  • Composable commands: Commands should be modular and reusable, use command composition
  • Strategy pattern: Use strategy pattern for branching workflows or task-based commands
  • Output formatting: Proper formatting with unicode symbols and color support

Framework Selection

TypeScript/JavaScript

stricli (@bloomberg/stricli, recommended for modern async-first CLIs):

  • Built for async/await from ground up
  • Type-safe command definitions with full type inference
  • Lazy loading for startup performance
  • Zero dependencies

oclif (alternative):

  • Mature framework with extensive features
  • Plugin system
  • Good for complex CLIs

Python

Sponsors

Details

Repository
github.com/siviter-xyz/dot-agent
Categories
DevOps & CI/CD, AI & Agent Building, Design & UI/UX, CLI & Terminal
First seen
Jun 3, 2026

More from siviter-xyz/dot-agent

All 11
1hairyf avatarvitehairyf/skillsVite build tool configuration, plugin API, SSR, and Vite 8 Rolldown migration. Use when working with Vite projects, vite.config.ts, Vite plugins, or building li200skills.sh installs
2openai avatarcode-change-verificationopenai/openai-agents-pythonRun the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents Python repository.200skills.sh installs
3senpi-ai avataremerging-moverssenpi-ai/senpi-skillsLightweight scanner tracking Smart Money market concentration across all Hyperliquid assets. Flags assets accelerating up the ranks before they become crowded t197skills.sh installs
4josiahsiegel avatardebugging-troubleshooting-2025josiahsiegel/claude-plugin-marketplaceComprehensive bash script debugging and troubleshooting techniques for 2025. PROACTIVELY activate for: (1) debugging a misbehaving bash script, (2) using set -x196skills.sh installs
5borghei avatarsenior-data-engineerborghei/claude-skillsData engineering for batch and streaming pipelines with Airflow, dbt, Spark, and Kafka. Use when designing data architectures, building pipelines, adding data-q195skills.sh installs
6odyssey4me avatargoogle-slidesodyssey4me/agent-skillsMarkdown-driven presentation builder with Google Slides upload. Write Markdown, build .pptx locally, review in LibreOffice, upload to Google Slides.195skills.sh installs