SkillFoxx
Telegram

Sensei — скилл

Проверяет frontmatter скиллов Agent Skills, оценивает его и по циклу Ральфа шаг за шагом улучшает описание и объем скилла.

  • 60 ★ репозитория
  • Последний коммит
Скилл

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

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

  • Скилл правит SKILL.md проверяемых скиллов и в режиме GEPA вызывает модель.
Все причины и проверки

spboyer/senseiАвтор:spboyer

Установка

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

npx skillfoxx add skills/sensei

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

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

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

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

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

  • Скилл правит SKILL.md проверяемых скиллов и в режиме GEPA вызывает модель.

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

Что делает

Sensei читает скилл, считает его токены и оценивает frontmatter: есть ли триггеры, не слишком ли размыто описание, не раздут ли текст. Затем цикл Ральфа повторяет шаги: улучшить описание, прогнать тесты, пересчитать токены и показать до и после. Каждый круг заканчивается вопросом: закоммитить, завести задачу или пропустить. Проверки спецификации Agent Skills (`name` и `description`) отделены от советов самого Sensei: лимиты в 150 знаков и 500 токенов он называет эвристиками. Режим `score` работает без вызовов модели. Есть режим `--gepa` для глубокой оптимизации, CLI `@spboyer/sensei` и GitHub Action для проверки в CI.

Для кого. Авторам скиллов, у которых агент вызывает не тот скилл или не вызывает нужный из-за слабого описания и раздутого SKILL.md.

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

  • Два похожих скилла конфликтуют, и агент выбирает не тот.
  • Описание скилла не называет триггеров, поэтому он почти не срабатывает.
  • SKILL.md разросся и занимает лишнее место в контексте.
  • Нужен отчет `sensei-audit.md` и строгая проверка скиллов в CI.

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

  • Нужна проверка безопасности: статические оценки не заменяют аудит.
  • Требуется доказать реальное срабатывание скилла: оценка по тексту его не наблюдает.
  • Нет Node.js 22 или новее: исходный CLI на нем держится.

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

Run sensei on my-skill-name и покажи оценку до и после, а потом предложи коммит.

Ограничения

Оценки статические: они не наблюдают реального срабатывания скилла и не служат проверкой безопасности. Порог Medium-High задан как совет Sensei, а не уровень соответствия спецификации. Опубликованные пакеты и теги Action могут отставать от ветки `main`, поэтому для свежих функций README советует клонировать репозиторий и ставить зависимости в `scripts`. Нужен Node.js 22.12 или новее. Для режима GEPA дополнительно требуются Python 3.10 и uv, а выполнение улучшений вызывает модель и расходует токены.

Как отключить. Удалите склонированную папку `~/.copilot/skills/sensei` или `.github/skills/sensei`. Глобальный CLI снимите командой `npm uninstall --global @spboyer/sensei`.

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

Как запустить проверку без модели?

Выполните `npx @spboyer/sensei score .`. Режим score оценивает frontmatter и токены без вызовов модели. Строгую проверку для CI дает `npx @spboyer/sensei check --root . --strict`.

Что такое цикл Ральфа?

Это повтор из восьми шагов: прочитать, оценить, улучшить, проверить тесты, пересчитать токены, показать итог, спросить, что делать, и повторять до целевой оценки.

Можно ли использовать Sensei в GitHub Actions?

Да. Подключите `spboyer/sensei@v1.5.0` с командой `check` и параметрами `root` и `path`. Тег может отставать от `main`.

Что оценивает Sensei в скилле?

Наличие триггеров, ясность описания, объем в токенах и соответствие frontmatter спецификации Agent Skills. Лимиты в 150 знаков и 500 токенов проект называет эвристикой.

Что нужно поставить заранее?

Для исходного CLI нужны Node.js 22.12 или новее и `npm install` в папке `scripts`. Для режима GEPA еще понадобятся Python 3.10 и uv.

Обсуждение

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

Скиллы

Скилл для создания, проверки и улучшения других скиллов: сначала архитектура, потом тесты, оценка и упаковка

СкиллРасширенный доступ212

Автономный цикл разработки по спецификациям: агент берет задачу, сверяет критерии приемки и коммитит, пока список не кончится.

СкиллШирокий доступ313

Каталог из почти двухсот скиллов: доставка кода, ревью, отладка, управление ИИ, продуктовая работа и координация агентов.

СкиллМинимальный доступ174

Консольная программа гоняет агента по задачам и меняет его скиллы, пока проверка на отложенных задачах не подтвердит прирост

CLIШирокий доступ287

Метаскилл превращает разрозненные правила в AGENTS.md, CLAUDE.md и Cursor в один проверяемый скилл проекта с маршрутами задач.

ПлагинРасширенный доступ622

Скилл-врач для скиллов: выбирает архитектуру, проверяет по чек-листу с 21 красной линией и выдает отчет со ссылками на строки

СкиллРасширенный доступ267

Коротко о README

Проект проверяет переносимый frontmatter Agent Skills и добавляет необязательные рекомендации. Улучшение идет циклом с подтверждением человека, а токенный бюджет скилла держится под контролем.

Бейдж для README

Исходный SKILL.md

---
name: sensei
description: "**WORKFLOW SKILL** - Iteratively improve skill frontmatter and routing clarity. WHEN: \"run sensei\", \"sensei help\", \"improve skill\", \"fix frontmatter\", \"score skill\", \"check skill tokens\". INVOKES: token CLI, test runners, git. FOR SINGLE OPERATIONS: use the token CLI directly."
---

# Sensei

Improve skills using the [Ralph loop](references/loop.md). For help, explain modes,
defaults, and checks from [configuration](references/configuration.md).
For source bundles and installation, see [distribution](references/distribution.md).

1. **Read** the target `SKILL.md`, references, tests, and repo-local instructions.
   Verify tooling exists before claiming it is missing. Count baseline tokens:
   From the Sensei checkout, pass the target repository root and a path relative
   to it: `npm run tokens -- count --root <target-repo> <skill-path>/SKILL.md`.
2. **Score** with `npm run tokens -- score --root <target-repo> <skill-path>`.
   Separate portable-spec
   diagnostics from [Sensei recommendations](references/scoring.md).
   Preserve `.sensei.json` and AGENTS.md short-description policy. A 150-character
   floor, 60-word target, type prefix, `WHEN:`, and 500-token target are heuristics,
   not specification requirements.
3. **Scaffold** missing tests using [templates](references/test-templates/skill-init.md).
   Use realistic positive prompts and close near-misses from intended scope;
   negative frontmatter syntax is not required.
4. **Improve** concise positive routing and operational instructions using
   [examples](references/examples.md). Keep descriptions non-empty and within
   1024 characters. Preserve meaningful boundaries; evaluate them on the target host.
   Check [portability](references/portability.md) before introducing host fields.
5. **Verify** with the target project's test runner; `--fast` skips tests but must
   report them as not run. GEPA mode uses optional keyword/proxy fitness, not
   observed host activation; follow [configuration](references/configuration.md).
6. **Check budgets** with
   `npm run tokens -- check --root <target-repo> <skill-path>/SKILL.md`.
   Report configured token-limit warnings separately from optional optimization
   suggestions. For MCP-aware skills, follow [MCP integration](references/mcp-integration.md).
7. **Summarize** changes, diagnostics, tests, token deltas, and remaining suggestions.
   `score --emit-proof` records static evidence, not runtime quality or a security audit.
   Ask whether to commit, create an issue, or skip; do not discard edits unasked.
8. **Repeat** until the advisory target and tests pass, at most five iterations.
   Process batches sequentially and report failures explicitly.

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