Prompt Sensei — скилл

Локальный тренер промптов для Claude Code и Codex: оценивает запрос по стадии работы, переписывает его и учит одной привычке.

  • 109 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Расширенный доступ

Почему такой уровень

  • Необязательные хуки читают события сессии, а `lookback` читает локальную историю Claude Code и Codex после согласия.
  • Скилл пишет метаданные в `~/.prompt-sensei/`.
Все причины и проверки

chengzhongwei/prompt-sensei

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/prompt-sensei

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Необязательные хуки читают события сессии, а `lookback` читает локальную историю Claude Code и Codex после согласия.
  • Скилл пишет метаданные в `~/.prompt-sensei/`.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Prompt Sensei — скилл для Claude Code и Codex, который работает как тихий тренер по промптам. Команда `/prompt-sensei improve` переписывает черновой запрос и называет пробелы в нем. Режим `observe` добавляет к ответу агента короткую строку с оценкой и советом. Оценка зависит от стадии работы: исследование, диагностика, исполнение, проверка, повторяемый процесс или короткое действие. Команда `lookback` по отдельному согласию разбирает локальную историю сессий, `report` показывает тренды. Метаданные хранятся в `~/.prompt-sensei/`, сырые промпты скилл не сохраняет.

Для кого. Разработчикам, которые ставят задачи Claude Code или Codex расплывчато и хотят вырабатывать привычку писать запросы точнее.

Подходит, если

  • Запрос вроде «починить тест» дает расплывчатый ответ, и его нужно переписать.
  • За сессию хочется видеть подсказку к каждому ответу агента, для этого включают `observe`.
  • Прошлые сессии разбирают по привычкам: какие пробелы в запросах повторяются.
  • Команда учится формулировать запросы к агенту по общей рубрике оценки.

Не подходит, если

  • Работа идет в Cursor или другом агенте: поддерживаются только Claude Code и Codex.
  • Политика запрещает локальные хуки и запись в домашний каталог.
  • Нужна объективная оценка качества промпта: балл служит подсказкой.

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

Запусти `/prompt-sensei improve "fix this test"` и покажи, чего не хватает в запросе.

Ограничения

Поддерживаются Claude Code и Codex, Cursor и другие инструменты пока нет. Команду `/prompt-sensei` понимает только Claude Code, в Codex пишут естественным языком. Установка требует `npm install` и `npm run build` в каталоге скилла. Хуки автозапуска необязательны, а Codex просит подтвердить новые команды хуков перед запуском. Балл служит сигналом для обучения, гарантии лучшего результата он не дает.

Как отключить. Выполните `/prompt-sensei stop` для текущей сессии, уберите хуки автозапуска из настроек Claude Code или Codex и удалите каталог скилла. Локальные данные стирает `/prompt-sensei clear`.

Частые вопросы

Какие команды есть у Prompt Sensei?

`observe` запускает живые подсказки, `improve` переписывает запрос, `lookback` разбирает историю, `setup` ведет настройку, `help` показывает справку. Дополнительно есть `stop`, `report`, `settings`, `update` и `clear`.

Что хранится на диске?

Только локальные метаданные в `~/.prompt-sensei/`, и только после вашего согласия. Сырые промпты не сохраняются. Предпросмотр с вырезанными секретами по умолчанию выключен.

Как пользоваться скиллом в Codex?

Пишите естественным языком, например «Use prompt-sensei observe mode». Автозапуск через хуки включает `npm run setup-hooks -- auto-observe folder`, при первом запуске Codex попросит подтвердить хуки.

Что значит оценка 68 из 100?

Готовность запроса для текущей стадии работы, а не универсальное качество. Запрос на 100 баллов может дать слабый ответ, если модели не хватает знаний по теме.

Уходят ли запросы в сеть?

Нет. Локальные скрипты не отправляют тексты запросов, оценки и отчеты никакому сервису. В режиме `lookback` после отдельного согласия агент получает очищенные запросы пользователя.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

RePrompter разбирает сырой запрос интервью, превращает его в структурный промпт с оценкой или в промпт для сборки проекта целиком.

СкиллРасширенный доступ120Звезды репозитория

Плагин с хуками добавляет контекст к промпту Claude Code и задает от одного до шести вопросов, когда запрос расплывчатый.

ПлагинРасширенный доступ2 тыс.Звезды репозитория

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

ПромптМинимальный доступ1,2 тыс.Звезды репозитория

Скилл пишет точные промпты под конкретный инструмент: Cursor, Claude Code, Midjourney, Stable Diffusion и другие

СкиллМинимальный доступ15,9 тыс.Звезды репозитория

Плагин с шестью рабочими скиллами и библиотекой промптов: подбор промпта под задачу, проверки перед коммитом, аудит скиллов.

ПлагинРасширенный доступ56Звезды репозитория

Скилл оценивает промпт по пяти критериям, подбирает один из 31 фреймворка и переписывает запрос после уточняющих вопросов

СкиллМинимальный доступ333Звезды репозитория

Коротко о README

В репозитории лежат рубрика оценки, документы о приватности и философии, примеры хуков для Claude Code и Codex и скрипты на TypeScript. Отдельный раздел объясняет, как проверить пользу: меньше уточняющих ходов и неожиданных правок.

Бейдж для README

Исходный SKILL.md

---
name: prompt-sensei
description: Stage-aware prompt coaching, prompt improvement, lookback analysis, prompting habit feedback, and local reports about prompt quality for AI coding agents such as Claude Code or Codex.
argument-hint: "[observe|improve|lookback|setup|help]"
---

# Prompt Sensei

Prompt Sensei is a quiet, encouraging prompt mentor for engineers using AI coding agents such as Claude Code and Codex. Be a teacher, not a judge. Give stage-aware, specific feedback that helps the user improve one habit at a time.

If observation mode is active, every final answer to a normal user prompt must end with exactly one Sensei line. Do not add Sensei lines to interim progress updates, tool-status updates, working notes, or collapsed/expandable thinking-progress blocks. Exceptions: `/prompt-sensei stop`, `/prompt-sensei help`, `/prompt-sensei clear`, `/prompt-sensei update`, and cases where the user explicitly asks you not to respond normally.

## Invocation

Essential commands:

- `/prompt-sensei` or `/prompt-sensei observe` — activate coaching for this session
- `/prompt-sensei observe --auto-start` — silently activate coaching from trusted host hooks
- `/prompt-sensei improve <prompt>` — score and minimally improve one prompt
- `/prompt-sensei lookback` — analyze selected local Claude Code or Codex history after separate consent
- `/prompt-sensei setup` — guided setup for consent, auto-start scope, and optional redacted previews
- `/prompt-sensei help` — show concise help

Advanced commands:

- `/prompt-sensei stop`
- `/prompt-sensei report`
- `/prompt-sensei settings`
- `/prompt-sensei settings auto-observe on|off|folder|user`
- `/prompt-sensei settings save-redacted-prompts on|off`
- `/prompt-sensei settings auto-observe=off save-redacted-prompts=on`
- `/prompt-sensei clear`
- `/prompt-sensei update`

Natural-language equivalents in Codex include "use prompt-sensei", "improve this prompt", "look back at my prompt history", "show my prompt-sensei report", "use prompt-sensei setup", and "turn auto observe on". Settings commands accept friendly values such as `enable/disable`, `true/false`, and aliases such as `redacted`, `previews`, and `auto-start`.

When running scripts, use the installed skill root:

- Claude Code: `~/.claude/skills/prompt-sensei`
- Codex: `~/.codex/skills/prompt-sensei`

For setup, settings, hooks, and lookback details, read [docs/skill-flows.md](docs/skill-flows.md) only when that mode is requested.

## Stages

Сообщить о проблеме