# unix-cli

Набор правил для ИИ-агента, который пишет или проверяет консольные утилиты: аргументы, коды выхода, потоки вывода.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 319 установок · ★ 218
- Автор: pproenca
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/unix-cli/SKILL.md
- Обновлён: 2026-08-15
- HTML: https://affpapa.org/nevibecode/skills/unix-cli

## Что делает

Скилл задаёт 44 правила в 8 категориях, отсортированных по важности: от критичных (разбор аргументов, коды выхода, потоки вывода) до второстепенных (конфигурация и переменные окружения). Каждое правило лежит в отдельном файле в `references/` и снабжено пояснением с примерами кода. Агент подтягивает нужный файл, когда задача касается флагов, `stdout`/`stderr`, сигналов или shell-скриптов.

Правила опираются на POSIX-соглашения. Скажем, данные идут только в `stdout`, диагностика — в `stderr`, успех кодируется нулём, а завершение по сигналу — кодом 128+N. Есть отдельные пункты про `--help` и `--version`, про `--` как терминатор опций, про `NO_COLOR` и про XDG Base Directory. Для секретов правило прямое: не читать их из флагов командной строки и не хранить в конфигах.

Скилл пригодится, если вы пишете утилиту, которая должна встраиваться в конвейер с `grep`, `xargs` и прочими соседями. Без этого агент легко сделает прогресс-бар в `stdout` и сломает пайп. Установка идёт через `npx skills add`, для GitHub Copilot — через `gh skill install`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill unix-cli -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/unix-cli/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/unix-cli/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill unix-cli -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/unix-cli/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill unix-cli -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/unix-cli/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills unix-cli
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/unix-cli/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill unix-cli -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.experimental/unix-cli
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/unix-cli/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill unix-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.experimental/unix-cli/SKILL.md

## Когда брать
- разобрать флаги и позиционные аргументы по стандарту
- выбрать код выхода для частичного успеха
- развести данные и диагностику по разным потокам
- обработать SIGINT и SIGPIPE без мусора в выводе
- проверить готовую утилиту на совместимость с конвейером

## Примеры запросов агенту
- напиши CLI на Python, который читает список файлов из stdin и печатает результат в stdout
- проверь мой скрипт на соответствие POSIX: коды выхода, stderr, обработка SIGINT
- добавь в утилиту --help, --version и поддержку -- как терминатора опций

## Похожие
- [unix-goto-development](https://affpapa.org/nevibecode/skills/unix-goto-development.md) — скилл · 427 установок
- [hyva-exec-shell-cmd](https://affpapa.org/nevibecode/skills/hyva-exec-shell-cmd.md) — скилл · 1300 установок
- [bash-script-generator](https://affpapa.org/nevibecode/skills/bash-script-generator.md) — скилл · 670 установок
- [mcp-cli](https://affpapa.org/nevibecode/skills/mcp-cli.md) — скилл · 9650 установок
- [debug-window](https://affpapa.org/nevibecode/hooks/debug-window.md) — хук · 189 установок
- [c-pro](https://affpapa.org/nevibecode/agents/c-pro.md) — субагент · 650 установок

Из того же набора: [pproenca/dot-skills](https://affpapa.org/nevibecode/by/pproenca/dot-skills.md) — 45 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md