К основному содержанию
скилл CX Codex

cli-building — скилл для Claude Code: что делает и как установить

Скилл cli-building задаёт правила создания консольных утилит: асинхронный ввод-вывод, модульная композиция команд и форматирование терминального вывода с учётом NO_COLOR.

MIT 201 установок ★ 22 обновлён 2026-03-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add siviter-xyz/dot-agent --skill cli-building -a claude-code
Открыть на GitHub

Что делает cli-building

Скилл инструктирует агента проектировать интерфейсы командной строки с упором на асинхронные вызовы и композицию модулей. Вместо блокирующих операций ввода-вывода для файлов, сети и процессов агент применяет async/await, а для ветвления сложных сценариев внедряет паттерн «Стратегия».

В стек рекомендаций включены конкретные библиотеки. Для TypeScript и JavaScript предлагается @bloomberg/stricli с ленивой загрузкой команд без внешних зависимостей либо oclif для сложных систем с плагинами. Для Python скилл выбирает асинхронный фреймворк cyclopts или typer.

В оформлении терминального вывода действует жёсткое ограничение: эмодзи запрещены, статус операций отображается символами вроде ✓ или ✗, а цвета настраиваются только через библиотеки с обязательной поддержкой переменной NO_COLOR.

Какие задачи решает

  • спроектировать структуру командной строки на базе stricli или cyclopts
  • настроить асинхронную обработку сетевых и файловых вызовов в CLI
  • реализовать форматирование вывода через символы Юникода без использования эмодзи
  • организовать обработку кодов выхода и ошибок асинхронных цепочек

Примеры запросов агенту

  • Спроектируй CLI-утилиту для скачивания отчётов на TypeScript с библиотекой stricli
  • Добавь команду миграции данных на Python с помощью cyclopts и асинхронных вызовов
  • Настрой форматирование терминального вывода с поддержкой переменной NO_COLOR

Как установить cli-building

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/cli-building/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cli-building/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cli-building

Как установить cli-building в Claude Code?

Выполните команду npx skills add siviter-xyz/dot-agent --skill cli-building -a claude-code. Также можно вручную поместить файл инструкции по пути ~/.claude/skills/cli-building/SKILL.md.

Какие фреймворки рекомендует этот скилл?

В TypeScript он советует использовать @bloomberg/stricli или oclif. В проектах на Python инструкция делает выбор в пользу cyclopts либо typer.

Как настраивается терминальный вывод?

Инструкция запрещает эмодзи, если они прямо не запрошены, предписывает символы Юникода для статусов и требует поддержки переменной окружения NO_COLOR.

Исходный текст

SKILL.md · MIT
---
name: cli-building
description: Build command-line interfaces with async-first design, composable commands, and proper output formatting. Use when creating CLI tools, commands, or interactive terminal applications.
---

# 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

**cyclopts** (recommended for async-first):
- Modern async-first CLI framework
- Type-safe with excellent async support
- Clean API design

**typer** (when fully async support available):
- Based on Python type hints
- Clean and intuitive
- Good for simple to medium complexity CLIs

## Command Architecture

### Composable Commands

Design commands as reusable modules:
- Shared command utilities
- Command middleware
- Reusable command modules
- Command composition patterns

### Strategy Pattern

Use strategy pattern for:
- Workflow branching
- Task-based commands
- Dynamic command routing
- Conditional command execution

## Output Formatting

- **No emojis**: Do not use emojis unless explicitly directed
- **Unicode symbols**: Use unicode symbols (✓, ✗, →, ⚠) for status indicators
- **Color support**: Use color libraries, never hardcoded ANSI codes
- **NO_COLOR**: Always respect `NO_COLOR` environment variable
- **Formatting**: Use formatting for better readability (bold, dim, etc.)

## Async Patterns

### Async-First Design

All I/O should be async:
- File operations: use async file APIs
- Network requests: use async HTTP clients
- Process execution: use async process APIs
- Database operations: use async database clients

### Error Handling

Handle async errors properly:
- Use try/catch with await
- Handle promise rejections
- Provide clear error messages
- Exit with appropriate codes

## Command Structure

### Basic Command

```typescript
// stricli example
import { createCli } from '@bloomberg/stricli';

async function myCommand() {
  // Async implementation
}

const cli = createCli({
  name: 'my-cli',
  commands: {
    'my-command': myCommand
  }
});

cli.run();
```

```python
# cyclopts example
from cyclopts import App

app = App()

@app.default
async def my_command():
    # Async implementation
    pass

if __name__ == '__main__':
    app()
```

## Best Practices

1. **Async by default**: All operations should be async
2. **Composable design**: Build reusable command modules
3. **Strategy pattern**: Use for workflow branching
4. **Proper formatting**: Unicode symbols and color with NO_COLOR support
5. **Error handling**: Clear error messages and exit codes
6. **Type safety**: Use TypeScript types or Python type hints
7. **Testing**: Test commands in isolation

## References

For detailed guidance, see:
- `references/async-patterns.md` - Async/await best practices
- `references/composable-commands.md` - Command composition patterns
- `references/strategy-pattern.md` - Strategy pattern for workflows
- `references/output-formatting.md` - Output formatting guidelines
- `references/frameworks.md` - Framework comparisons and selection

© siviter-xyz · MIT · siviter-xyz/dot-agent

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
building-with-medusa medusajs Скилл building-with-medusa для Claude Code и Codex направляет разработку бэкенда на Medusa. Подключается при проектировании модулей, маршрутов API, воркфлоу и связей данных. CX Codex +1 5 000установок building-pydantic-ai-agents pydantic Скилл building-pydantic-ai-agents учит помощника проектировать приложения на Pydantic AI с инструментами и валидацией ответов. Пригодится при сборке типизированных агентных систем. CX Codex +1 6 600установок building-edgespark-apps EdgeSpark Скилл building-edgespark-apps задаёт правила разработки проектов на платформе EdgeSpark. Помогает агенту правильно работать с CLI, базой данных и авторизацией. CX Codex +1 580установок building-components vercel Скилл building-components помогает проектировать доступные UI-компоненты, их API, темы и документацию. CX Codex +1 15 400установок building-tools celigo building-tools — скилл для Claude Code, который помогает собирать переиспользуемые инструменты Celigo с входными и выходными контрактами. Он включается при создании инструмента, добавлении шагов или настройке маршрутизации. CX Codex +1 4 000установок building-apis celigo Скилл building-apis для Claude Code, Codex, Cursor и других AI-кодеров, который учит создавать RESTful endpoint'ы, через которые внешние системы могут синхронно запрашивать или отправлять данные в интеграции. CX Codex +1 4 000установок

Из того же набора11

Весь набор →
software-engineer Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок python Задаёт единый стиль Python: типизация, внедрение зависимостей, структура тестов и модулей. Держит код в одном порядке при правках в существующем проекте. CX Codex +1 353установок create-agents-md Скилл create-agents-md помогает составить файл AGENTS.md с точечными правилами для репозитория. Пригодится при настройке стиля кода, команд сборки и ограничений для ИИ-агентов. CX Codex +1 306установок typescript Скилл typescript для Claude Code задаёт стандарты написания и изменения кода на TypeScript. Активируется при работе с файлами TypeScript и TypeScript React. CX Codex +1 239установок semantic-git Скилл semantic-git для Claude Code группирует связанные изменения в атомарные коммиты и оформляет сообщения в Conventional Commits. Готовит изменения к коммиту. CX Codex +1 201установок debugging Скилл debugging для Claude Code пошагово ищет первопричину сбоев и ошибок в коде. Помогает локализовать баг и подготовить минимальное исправление. CX Codex +1 151установок media-processing Скилл media-processing для Claude Code автоматизирует пакетную обработку медиа: сжатие видео, ресайз картинок и конвертацию аудио через FFmpeg и ImageMagick. CX Codex +1 151установок psi psi ведёт разработку через план, спецификацию и реализацию с тестами. Скилл запускается только по прямой просьбе или по упоминанию в AGENTS.md. CX Codex +1 144установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой