cli

Comprehensive R package for command-line interface styling, semantic messaging, and user communication. Use this skill when working with R code that needs to: (1) Format console output with inline markup and colors, (2) Display errors, warnings, or messages with cli_abort/cli_warn/cli_inform, (3) Show progress indicators for long-running operations, (4) Create semantic CLI elements (headers, lists

PPPosit, PBC official Разработка

Что делает навык

Навык предоставляет инструменты для создания структурированного и семантического вывода в консоли R, заменяя стандартные функции на расширенные аналоги cli. Он позволяет форматировать текст с помощью встроенной разметки, управлять прогресс-барами и генерировать информативные сообщения об ошибках, предупреждениях и статусе выполнения.

Когда применять

  • Форматирование консольного вывода с использованием цветов и встроенной разметки для выделения кода, путей или имён пакетов.
  • Отображение структурированных ошибок, предупреждений или информационных сообщений через cli_abort, cli_warn и cli_inform.
  • Показ индикаторов прогресса для длительных операций с помощью cli_progress_bar или cli_progress_step.
  • Создание семантических элементов интерфейса, таких как заголовки, списки и алерты различных типов.
  • Обработка множественного числа и автоматическое сворачивание векторов в читаемый текст.

Как работает

  1. Использовать функции cli_abort(), cli_warn() или cli_inform() для вывода сообщений, применяя синтаксис inline-разметки {.class content} для форматирования.
  2. Применять буллиты ("x", "!", "i", "v") внутри векторов строк для добавления контекста и структурирования сообщений об ошибках или предупреждениях.
  3. Создавать индикаторы прогресса с помощью cli_progress_bar() для итерационных задач или cli_progress_step() для последовательных этапов.
  4. Использовать синтаксис {?s} или {?y/ies} для автоматической обработки множественного числа и функции no() для отображения слова 'no' вместо нуля.
  5. Форматировать специфические элементы текста с помощью классов разметки, таких как {.code}, {.fn}, {.file}, {.pkg}, {.var}, {.val}, {.emph}, {.strong} и {.field}.

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

Напиши функцию на R, которая проверяет существование файла и выводит красивую ошибку с путём к файлу через cli_abort, если файл не найден.
Создай скрипт для обработки списка файлов, который показывает прогресс-бар с текущим статусом и количеством обработанных элементов.
Сформируй сообщение об ошибке с использованием cli_inform, включающее заголовок, список найденных пакетов и предупреждение о необходимости обновления.

Что понадобится

  • Пакет cli для R
  • Пакеты rlang и glue (используются для обработки условий и интерполяции строк)

Описание составлено по SKILL.md навыка, сверено 15.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «cli» из репозитория: # https://github.com/posit-dev/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r cli/ ~/.claude/skills/cli/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.