К основному содержанию
скилл CX Codex

justfile-expert — скилл для Claude Code: Justfile и установка

Скилл justfile-expert для Claude Code создаёт и правит Justfile: описывает рецепты, параметры, зависимости и модули. Настраивает команды проекта и автоматизацию задач.

MIT 162 установок ★ 60 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill justfile-expert -a claude-code
Открыть на GitHub

Что делает justfile-expert

Скилл помогает проектировать структуру Justfile, настраивать рецепты для Linux, macOS и Windows, передавать параметры и связывать задачи зависимостями. Он охватывает shebang-рецепты, переменные окружения, загрузку dotenv и организацию больших файлов по модулям. Также подсказывает, как оформить команды проекта единообразно и подключить рецепты к CI/CD.

Отдельное внимание уделено тонкостям синтаксиса. Интерполяция Just вставляет текст до разбора командной оболочкой, поэтому значение с пробелами нужно передать через quote(); иначе один аргумент может превратиться в несколько. Скилл также объясняет, как [doc] влияет на вывод just --list и почему вставка рецепта может переназначить комментарий. Для стандартного набора рецептов он ссылается на references/standard-recipes.md, а описания возможностей — на references/key-capabilities.md.

Какие задачи решает

  • спроектировать структуру Justfile для проекта
  • передать параметры рецепту, не разбив аргумент с пробелами
  • связать рецепты зависимостями
  • разнести команды по модулям и настроить платформенные варианты
  • оформить описание рецепта для just --list

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

  • Помоги составить Justfile с командами сборки, тестов и очистки проекта.
  • Проверь, почему аргумент с пробелами в рецепте caption разбивается на несколько частей.
  • Разложи рецепты большого Justfile по модулям и проверь их описание в just --list.

Как установить justfile-expert

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill justfile-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/justfile-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/justfile-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о justfile-expert

Как установить justfile-expert в Claude Code?

Выполните npx skills add laurigates/claude-plugins --skill justfile-expert -a claude-code. Файл скилла находится по пути ~/.claude/skills/justfile-expert/SKILL.md.

Что делает justfile-expert?

Он помогает писать и приводить к единой структуре Justfile: настраивать рецепты, параметры, зависимости и модули, а также разбирать особенности синтаксиса Just.

Почему аргумент с пробелами распадается на части в Justfile?

Интерполяция вставляется в тело рецепта до того, как оболочка разбирает команду. Для именованных параметров с пробелами используйте quote(); отдельные значения в *ARGS с пробелами нужно оформить именованными параметрами.

Исходный текст

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-02-06
name: justfile-expert
description: Just command runner expertise — Justfile syntax, recipes, parameters, modules, shebang recipes. Use when authoring justfiles, project commands, or task automation.
user-invocable: false
allowed-tools: Bash(just --list *), Bash(just -l *), Bash(just --summary *), Bash(just --dump *), Bash(grep *), Bash(python3 ${CLAUDE_PLUGIN_ROOT}/scripts/just-recipe-help.py *), Grep, Glob, Read, Write, Edit, TodoWrite
model: sonnet
---

# Justfile Expert

Expert knowledge for Just command runner, recipe development, and task automation with focus on cross-platform compatibility and project standardization.

## When to Use This Skill

| Use this skill when... | Use alternative when... |
|------------------------|------------------------|
| Creating/editing justfiles for task automation | Need build system with incremental compilation → Make |
| Writing cross-platform project commands | Need tool version management bundled → mise tasks |
| Adding shebang recipes (Python, Node, Ruby, etc.) | Already using mise for all project tooling |
| Configuring dotenv loading and settings | Authoring the shell itself (pipes, traps, arg parsing) → `shell-expert` |
| Setting up CI/CD with just recipes | Project already has extensive Makefile |
| Standardizing recipes across projects | Exposing a module for bulk smoke-testing → `cli-smoke-recipes` |

## Core Expertise

**Command Runner Mastery**
- Justfile syntax and recipe structure
- Cross-platform task automation (Linux, macOS, Windows)
- Parameter handling and argument forwarding
- Module organization for large projects

**Recipe Development Excellence**
- Recipe patterns for common operations
- Dependency management between recipes
- Shebang recipes for complex logic
- Environment variable integration

**Project Standardization**
- Golden template with standard naming and section structure
- Self-documenting project operations
- Portable patterns across projects
- Integration with CI/CD pipelines

## Recipe Naming Conventions

| Rule | Pattern | Examples |
|------|---------|---------|
| Hyphen-separated | `word-word` | `test-unit`, `format-check` |
| Verb-first (actions) | `verb-object` | `lint`, `build`, `clean` |
| Noun-first (categories) | `noun-verb` | `db-migrate`, `docs-serve` |
| Private prefix | `_name` | `_generate-secrets`, `_setup` |
| `-check` suffix | Read-only verification | `format-check` |
| `-fix` suffix | Auto-correction | `lint-fix`, `check-fix` |
| `-watch` suffix | Watch mode | `test-watch`, `docs-watch` |
| Modifiers after base | `base-modifier` | `build-release` (not `release-build`) |

## Standard and Workflow Recipes

When creating or standardizing a project justfile, open [references/standard-recipes.md](references/standard-recipes.md) for the semantic composites (`check`, `pre-commit`, `ci`, `clean`, `clean-all`), the standard recipe set, and the section structure.

## Key Capabilities

Parameter forms, settings, recipe attributes (`[doc]`, `[private]`, `[group]`, `[confirm]`, platform), and the module system, including that `set fallback` is not inherited by a module: [references/key-capabilities.md](references/key-capabilities.md).

## Essential Syntax

**Basic Recipe Structure**
```just
# Comment describes the recipe
recipe-name:
    command1
    command2
```

**Recipe with Parameters**
```just
build target:
    @echo "Building {{target}}..."
    cd {{quote(target)}} && make

test *args:
    uv run pytest {{args}}
```

**Interpolation is UNQUOTED — quote anything that can contain spaces**

`{{...}}` splices raw text into the recipe body *before* the shell parses it,
so a value carrying spaces or quotes word-splits. This bites hardest on the
`*args` passthrough above, because the error is reported by the *called
program* rather than by just, which makes it read like a bug in the tool:

```just
# Trap — one argument with spaces arrives as several
caption *ARGS:
    ./tool.py {{ARGS}}
```

```
$ just caption ./data "the subject's face"
tool.py: error: unrecognized arguments: subjects face
```

The outer shell consumed the quotes (taking the apostrophe with them) and
`the` / `subject's` / `face` arrived as three separate argv entries. Name the
parameters that can contain spaces and run them through `quote()`, which emits
a properly shell-escaped literal:

```just
# Correct — named params are quoted; trailing flags still pass through
caption DIR SUBJECT="" *ARGS:
    ./tool.py {{quote(DIR)}} {{quote(SUBJECT)}} {{ARGS}}
```

`quote()` covers embedded spaces, `'`, `"`, and `$`. Keep `{{ARGS}}` bare —
that is what lets several trailing flags expand as separate words — and accept
its corollary: an individual passthrough flag's value must not contain spaces.
When one might, promote it to a named parameter too.

**What `--list` Shows Is ONE Line, and It Is Not Your Comment Block**

`just --list` renders a single description per recipe. With no `[doc]`
attribute it takes the **last line** of the comment block immediately above the
recipe — not the first line, and not the block:

| Above the recipe | `--list` shows |
|---|---|
| `[doc("Build the release bundle.")]` | that text |
| a comment block, no attribute | **only its last line** |
| bare `[doc]` | nothing |
| nothing | nothing |

So "add a comment before each recipe" is **not** the same as documenting it. A
block that ends in an example or a caveat — the normal way to write one — lists
as that fragment:

```just
# Pitch-correct the singing in an MP4. Video is stream-copied.
#   just autotune take.mp4 out.mp4 --key C:minor
autotune IN OUT *FLAGS:
```
```
$ just --list
    autotune IN OUT *FLAGS   # just autotune take.mp4 out.mp4 --key C:minor
```

**Add `[doc("one line")]` as soon as a recipe's comment block exceeds one
line.** The block stays where it is and keeps carrying the detail; the
attribute is the only thing `--list` reads.

**The block binds by ADJACENCY, and reassignment is silent.** A blank line ends
a block, so inserting a recipe between a block and the recipe it describes
hands the block to the newcomer — the original then lists blank, and nothing
warns. Re-read `just --list` after inserting a recipe into an existing file.

**A recipe with a required positional has no `--help` form.** `recipe *ARGS:`
forwards `--help` to the underlying tool, but just refuses the call before the
tool runs once a positional is required:

```
$ just autotune --help
error: recipe `autotune` got 1 positional argument but takes at least 2
```

There is no bare-help spelling for such a recipe. Put the flags in its `[doc]`
or comment block, or add a `help` recipe that prints them.

**Recipe Dependencies**
```just
default: build test

build: _setup
    cargo build --release

_setup:
    @echo "Setting up..."
```

**Variables and Interpolation**
```just
version := "1.0.0"
project := env('PROJECT_NAME', 'default')

info:
    @echo "Project: {{project}} v{{version}}"
```

**Conditional Recipes**
```just
[unix]
open:
    xdg-open http://localhost:8080

[windows]
open:
    start http://localhost:8080
```

## Gotchas

Sub-justfile settings and nested `just -f` calls, path arguments that resolve against the justfile directory, top-level backticks that run for every recipe, keep-awake wrappers, and notifier hooks: [references/gotchas.md](references/gotchas.md).

## Common Patterns

Setup, Docker, database, and CI/release recipes, plus how to pass per-project values into shared imports across modules (parameters, not shared variables): [references/common-patterns.md](references/common-patterns.md).

## MCP Integration (just-mcp)

To let an AI client list and run recipes over MCP instead of reading the justfile, see [references/mcp-integration.md](references/mcp-integration.md).

## Agentic Optimizations

| Context | Command |
|---------|---------|
| List all recipes | `just --list` or `just -l` |
| Dry run (preview) | `just --dry-run recipe` |
| Show variables | `just --evaluate` |
| Whole parsed justfile as JSON (recipes, params, deps, settings) | `just --dump --dump-format json` |
| Recipe names only | `just --summary` |
| Verbose execution | `just --verbose recipe` |
| Specific justfile | `just --justfile path recipe` |
| Working directory | `just --working-directory path recipe` |
| Choose interactively | `just --choose` |

## Best Practices

**Recipe Development Workflow**
1. **Name clearly**: Use descriptive, verb-based names (`build`, `test`, `deploy`)
2. **Document what `--list` reads**: a one-line comment is enough; anything
   longer needs `[doc("...")]`, or the listing shows only the block's last line
3. **Use defaults**: Provide sensible default parameter values
4. **Group logically**: section comments for the file, `[group("name")]` for the
   listing — a flat `--list` stops being scannable somewhere around 20 recipes
5. **Hide internals**: Mark helper recipes as `[private]`
6. **Test portability**: Verify on all target platforms

**Critical Guidelines**
- Always provide `default` recipe pointing to help
- Use `@` prefix to suppress command echo when appropriate
- Use shebang recipes for multi-line logic
- Prefer `set dotenv-load` for configuration
- Use modules for large projects (>20 recipes)
- Give a recipe a `[doc("...")]` when its comment block's last line would not
  read as a description on its own — `--list` shows only that line (see "What
  `--list` Shows" above). To find them:
  `python3 "${CLAUDE_PLUGIN_ROOT}/scripts/just-recipe-help.py" --audit`
- Include variadic `*args` for passthrough flexibility
- Quote all variables in shell commands — `{{...}}` interpolates **unquoted**,
  so wrap any parameter that can contain spaces in `quote()` (see
  "Interpolation is UNQUOTED" above); bare `{{args}}` is correct only for
  space-free passthrough flags

## Comparison with Alternatives

Feature table and when to pick Just, Make, or mise tasks: [references/comparison.md](references/comparison.md).

For the golden justfile template, detailed syntax reference, advanced patterns, and troubleshooting, see [REFERENCE.md](REFERENCE.md).

© laurigates · MIT · laurigates/claude-plugins

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
cli-just PaulRBerg Скилл cli-just настраивает автоматизацию задач через just: создаёт justfile, пишет рецепты и проверяет синтаксис под установленную в системе версию утилиты. CX Codex +1 796установок Just MCP Server PromptExecution Сервер открывает агенту рецепты из Justfile: он может найти команду, узнать её параметры и запустить её. Это удобнее, когда рабочие задачи уже описаны в Just. CX Codex +1 ★ 60звёзд репо just casey Справочник по just с синтаксисом justfile, рецептами и командами просмотра — чтобы читать и запускать задачи в проекте. CX Codex +1 1 200установок release ldayton Скилл release для Claude Code готовит релизный pull request с обновлением версии, синхронизацией зависимостей и списком изменений. Автоматизирует выпуск версий в проекте Dippy. CX Codex +1 ★ 244звёзд репо speckit.taskstoissues Chat2AnyLLM Команда speckit.taskstoissues преобразует список задач в упорядоченные по зависимостям GitHub issue, опираясь на дизайн-артефакты проекта. Работает только с публичными GitHub-репозиториями. CX Codex +1 ★ 117звёзд репо implement-task NeoLabHQ Скилл implement-task ведёт задачу по шагам: на каждый шаг отдельный агент, в конце фазы — один ревьюер и правки до прохода. CX Codex +1 1 300установок

Из того же набора27

Весь набор →
imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок jq-json-processing Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок python-development Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой. CX Codex +1 192установок generate-image Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок git-commit-workflow Скилл git-commit-workflow для Claude Code задаёт формат сообщений и правила staging. Помогает разделять изменения по смыслу и не смешивать файлы в одном коммите. CX Codex +1 161установок binary-analysis Скилл binary-analysis помогает агенту исследовать неизвестные бинарные файлы, дампить шестнадцатеричные данные и находить скрытые строки. CX Codex +1 146установок shell-expert Скилл shell-expert для Claude Code помогает писать скрипты Bash, zsh и POSIX, а также собирать автоматизацию из команд. Подключается к задачам с конвейерами и переносимым shell-кодом. CX Codex +1 141установок rust-development Скилл rust-development помогает писать и проверять Rust-код: от Cargo и владения памятью до async и Tokio. Срабатывает при задачах про Rust. CX Codex +1 108установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой