just — скилл для агентов
just
Справка по запуску рецептов и синтаксису justfile, которую автор just положил в репозиторий для агентов
- 36 479 ★ репозитория
- Последний коммит
- CC0-1.0
Расширенный доступ
Почему такой уровень
- Следуя скиллу, агент запускает рецепты `justfile`, а это произвольные команды оболочки и сценарии
- Скилл советует превращать частые команды в рецепты, поэтому агент может создавать и править `justfile` в проекте
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/justОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Следуя скиллу, агент запускает рецепты `justfile`, а это произвольные команды оболочки и сценарии
- Скилл советует превращать частые команды в рецепты, поэтому агент может создавать и править `justfile` в проекте
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл just — это один файл SKILL.md внутри репозитория casey/just, программы для запуска команд. Агент загружает его, когда в проекте есть `justfile` или пользователь упоминает just. Дальше файл объясняет, как узнать рецепты проекта, запустить нужный и написать новый. Для разведки в скилле перечислены ключи `just --list` (рецепты с описаниями), `just --show` (исходник рецепта), `just --dump` (весь файл), `just --evaluate` (значения переменных), `just --summary` и `just --help`. Для запуска указаны три формы: `just` для рецепта по умолчанию, `just <RECIPE>` и `just <RECIPE> <ARG1> <ARG2>` с аргументами. Образец синтаксиса показывает переменную, рецепты с зависимостями и параметрами, рецепт с `#!/usr/bin/env bash`, который записывается в файл и выполняется как сценарий. В заметках сказано, что комментарий перед рецептом становится его описанием в `just --list`, что по умолчанию каждая строка идет в новой оболочке и что часто используемые команды стоит превращать в рецепты.
Для кого. Для разработчиков, у которых команды проекта собраны в `justfile` и которые хотят, чтобы агент запускал сборку, тесты и публикацию через рецепты.
Подходит, если
- В проекте есть `justfile`, и агенту нужно узнать список рецептов с описаниями
- Агент должен запустить тесты или сборку через рецепт с аргументами, например `just test <name>`
- Нужно добавить в проект рецепт с зависимостями или с параметром по умолчанию
- Рецепт на bash надо написать как сценарий с `#!/usr/bin/env bash` и `set -euxo pipefail`
- Вы хотите, чтобы агент перед правкой смотрел исходник рецепта через `just --show`
Не подходит, если
- Проект собирается через make, npm scripts или другой инструмент: скилл описывает только just
- Нужна полная справка по модулям, импортам, атрибутам и настройкам: в скилле их нет, они описаны в README репозитория
- Программа just не установлена: скилл ее не ставит, сначала нужен пакетный менеджер, готовый бинарный файл или `cargo install just`
- Нужен MCP-сервер, через который агент запускает рецепты сам: скилл только объясняет команды, а MCP-адаптер автор just указывает отдельным проектом
Пример запроса к агенту
Покажи, какие рецепты есть в justfile этого проекта, и запусти тесты для пакета apiОграничения
Скилл короткий: около семидесяти строк с перечнем ключей, тремя формами запуска и одним образцом `justfile`. Остальной язык описан в README репозитория, и скилл на него не ссылается.
Программу just скилл не ставит. В README перечислены пакетные менеджеры, готовые бинарные файлы, `cargo install just` и пакет just-install для Node.js. Для Windows нужна оболочка sh из Git for Windows или Cygwin, либо другая оболочка через настройку `shell`.
Агент подхватывает скилл, когда видит `justfile` или слово just в запросе. Без этого условия справка не загружается.
Лицензия CC0-1.0.
Как отключить. Удалите папку скилла just из каталога скиллов вашего агента. Если вы ставили скилл командой `npx skills add casey/just --global`, найдите установленную папку just в глобальном каталоге скиллов и удалите ее. Сама программа just останется на месте, ее удаляют тем же менеджером пакетов, которым ставили.
Частые вопросы
Как поставить скилл?
Двумя способами: вручную, скопировав папку skills/just, или командой `npx skills add casey/just --global`.
Что показывает `just --list`?
Рецепты проекта вместе с описаниями. Описанием служит комментарий, который стоит строкой выше рецепта в `justfile`.
Как запустить рецепт с аргументами?
Напишите `just <RECIPE> <ARG1> <ARG2>`. В образце из скилла рецепт `test name` принимает имя теста, а рецепт `serve port='8080'` имеет порт по умолчанию.
Что будет, если рецепт начинается с `#!`?
Тело такого рецепта записывается в файл и выполняется целиком, как сценарий. Без `#!` каждая строка рецепта запускается в новой оболочке, поэтому переменные между строками не переходят.
Какой рецепт запускается по команде `just` без имени?
Рецепт с атрибутом `[default]`, а если такого нет, то первый рецепт в `justfile`. Это правило описано в документации программы, в самом скилле его нет.
Есть ли MCP-сервер для just?
В документации автор отсылает к стороннему проекту just-mcp в разделе про Model Context Protocol. Этот MCP-адаптер позволяет моделям читать содержимое `justfile` и запускать рецепты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для ревью кода по многим языкам и фреймворкам: архитектура, производительность, безопасность, антипаттерны и типичные ошибки
Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации
skill-creator — скиллы из OpenAPI, GraphQL и MCP
@asnd/skill-creator
Команда /skill-creator превращает ссылку на OpenAPI, GraphQL или MCP-сервер в готовый скилл с обертками и справочными файлами.
Скиллы команды Dart: тесты и моки, анализ и dart fix, CLI-приложения, FFI, документация и разбор конфликтов пакетов для ИИ-агента
agent-skills (misaka-mikoto-tech)
agent-skills
Три скилла одного автора для агента на Windows: безопасный PowerShell, чтение видео Bilibili и работа с открытым Unity Editor
Скилл, который вместо ASCII-схем в терминале собирает самодостаточные HTML-страницы: диаграммы, разбор диффов, ревью планов, таблицы и слайды
Коротко о README
Подробная документация по языку рецептов в одном файле: установка из пакетных менеджеров, готовых бинарных файлов и исходников, разделы про параметры, зависимости, атрибуты, выражения, строки, сценарные рецепты, настройки оболочки и файлы `.env`. Есть раздел про редакторы и языковой сервер. Короткий раздел о скилле указывает его папку и команду установки. Рядом лежит перевод документации на китайский и набор тестов.
Бейдж для README
Исходный SKILL.md
---
name: just
description: >
Reference for `just`, the command runner. Use when working in a project with
a `justfile` or when the user mentions `just` or `justfile`.
---
Just
====
Discovery
---------
- `just --dump` Print justfile
- `just --evaluate` Print variable values
- `just --help` Print detailed command-line syntax help
- `just --list` Print recipes with descriptions
- `just --show <RECIPE>` Print recipe source
- `just --summary` Print recipes without descriptiosn
Execution
---------
- `just` Run default recipe
- `just <RECIPE>` Run specific recipe
- `just <RECIPE> <ARG1> <ARG2` Run recipe with arguments
Syntax
------
```just
executable := 'main'
# compile main.c
compile:
cc main.c -o {{ executable }}
# run main
run: compile
./{{ executable }}
# run test
test name: compile
./bin/test {{ name }}
# start webserver
serve port='8080':
python -m http.server {{port}}
# publish current tag
publish:
#!/usr/bin/env bash
set -euxo pipefail
tag=`git describe --tags --exact-match`
./bin/check-tag $tag
git push origin $tag
```
Notes
-----
The comment proceeding a recipe is used as its doc-comment, and included in
`just --list`.
By default, each line of a recipe runs in a fresh shell. Recipes whose bodies
start with `#!` are written to a file and executed as a script.
Commonly used commands and scripts should be turned into `just` recipes.