ai-slash-commands

A tool for managing AI slash commands and prompts across multiple AI-powered editors. Write prompts once in markdown, and install them to Claude Code, Cursor, Windsurf, Codex, OpenCode, and Google Antigravity.

Quick start:

npx ai-slash-commands

Prompts list

Some of commands was copied from:

• https://github.com/hamzafer/cursor-commands

Один набор markdown-промптов в ./prompts/*.md, генерация в ./dist/** и установка в домашние папки для:

• Claude Code
• Cursor
• Windsurf (через линк в текущий workspace)
• Codex (custom prompts)
• OpenCode
• Google Antigravity

Почему так

• Источник истины - только prompt (markdown).
• id/имя команды вычисляется из имени файла (prompts/<name>.md).
• Всё сгенерированное лежит только в dist/.

Требования

• Node.js 18+ (Windows / Ubuntu)

Быстрый старт

1. Добавь промпты в prompts/*.md

2. Сгенерируй в dist:

npm run gen

3. Установи в домашние папки:

npm run install-configs

NPX

По умолчанию можно установить команды из встроенной папки ./prompts:

npx ai-slash-commands

Можно установить команды из любой папки с *.md файлами:

npx ai-slash-commands ./path/to/commands

Опционально можно ограничить список целей:

npx ai-slash-commands ./path/to/commands --targets claude,cursor

Windsurf: важный момент

Официально workflows подхватываются из .windsurf/workflows внутри workspace.
Глобальная папка workflows в home в доках не описана, поэтому тут используется компромисс:

• хранение в ~/.windsurf/workflows
• линк в конкретный репозиторий/папку workspace

Сделать линк для текущей папки:

npm run link:windsurf

Скрипты

• npm run gen - копирует prompts/*.md в:

  • dist/claude/commands/*.md
  • dist/cursor/commands/*.md
  • dist/windsurf/workflows/*.md
  • dist/codex/prompts/*.md
  • dist/opencode/commands/*.md
  • dist/antigravity/commands/*.md

• npm run install-configs - копирует из dist/** в:

  • ~/.claude/commands
  • ~/.cursor/commands
  • ~/.windsurf/workflows (хранилище, дальше линк)
  • ${CODEX_HOME:-~/.codex}/prompts
  • ~/.config/opencode/commands
  • ~/.gemini/antigravity/global_workflows

• npm run uninstall - удаляет из целевых папок файлы команд, перечисленные в dist/**

• npm run link:windsurf - делает .windsurf/workflows -> ~/.windsurf/workflows (symlink/junction)

• npm run changelog - перегенерирует CHANGELOG.md из conventional commits (git-cliff)

• npm run version:today - печатает версию релиза на сегодня в формате год.месяц.день (например 2026.5.28). При повторном релизе в тот же день добавляет патч: 2026.5.28.1

• npm run release - локально готовит релиз: bump package.json, обновляет CHANGELOG.md, коммит и тег vГГГГ.М.Д. Не пушит. Флаг --push — запушить ветку и тег (запускает GitHub-релиз), --dry-run — показать шаги без изменений

См. docs/RELEASING.md — как выпустить новую версию.

Skills

Помимо промптов (prompts/*.md), репозиторий содержит скиллы в skills/<name>/SKILL.md. Скилл — это директория с SKILL.md (frontmatter --- name / description ---) и любыми вспомогательными файлами (скрипты, тесты). При npm run gen каждый скилл:

• копируется целиком в dist/claude/skills/<name>/ (Claude Code умеет скиллы нативно);
• превращается в command-shim dist/<target>/<commandsDir>/<name>.md для всех целей (frontmatter срезается, первой строкой добавляется # <name> - <description>), так что /do, /commit доступны во всех редакторах.

npm run install-configs копирует dist/claude/skills/ → ~/.claude/skills/ (сохраняя исполняемый бит у *.py / *.sh), а npm run uninstall их удаляет.

Скилл do

do превращает docs/TODO.md проекта в автономный цикл «планируй и кодь»: /do оценивает список задач, выбирает режим планирования по сложности (ralphex-plan → ralphex для сложных / 3+ задач, brainstorm/plan для 1–2 задач, авто-режим для одной тривиальной) и редактирует список (do add / do remove, коммиты с префиксом task:), а также do early pr / do finalize. Подробности — в skills/do/SKILL.md.

Скилл todo-review

todo-review — read-only обзор по всем проектам: сканирует git-проекты в ~/projects, находит docs/TODO.md, печатает путь и полное содержимое каждого файла и выводит итоговую сводку (счётчики

• короткий вывод), ничего не редактируя. Дополняет do: показывает, где накопились задачи, а запуск работы оставляет за /do. Подробности — в skills/todo-review/SKILL.md.

Примечания по папкам (ссылки на доки)

• Claude Code personal commands: ~/.claude/commands
• Cursor global commands: ~/.cursor/commands
• Codex custom prompts: ~/.codex/prompts (или $CODEX_HOME/prompts)
• Windsurf workflows: .windsurf/workflows (workspace-level)
• OpenCode commands: ~/.config/opencode/commands
• Google Antigravity commands: ~/.gemini/antigravity/global_workflows