Build justfile

Skill gitt510/agent-skills/skills/build-justfile

Personal agent skills for Claude Code, Codex, and other Agent Skills-compatible agents, distributed via local symlinks.

Install

npx -y skills add gitt510/agent-skills --skill build-justfile

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

15 days oldThe repository was created 15 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Create or fully restructure a justfile so its recipes follow the de-facto conventions of prominent open-source justfiles. Use when writing a new justfile, cleaning up or normalizing an existing one, or porting a Makefile to just. Not for adding a recipe or two to an existing justfile — a normal edit covers that.

SKILL.md

5.0 KB, as published. Nobody here has run it

build-justfile

justfile を「just エコシステムの誰が読んでも予想通りに動く command runner」として書く。基準は個人の慣習ではなく、著名 OSS の justfile から実測できる de-facto convention。

de-facto の出典は実測した justfile 群: casey/just(作者本人)・oxc-project/oxc・ eza-community/eza・FuelLabs/sway ほか。ルールはこれらに共通する形だけを採る。どれかが独自にやっているだけの癖は採らない。

新規作成でも全面再構築でも、適用するルールは同じ。再構築のときは既存 recipe を 1 本ずつ convention に照合し、名前・引数・コメントを de-facto 側に寄せる。挙動（何を実行するか）は変えない — 変えるのは並べ方・名前・見え方だけ。

ルール

1. 先頭は private な `_default` で `just --list`

引数なしの just は「何ができるか」の一覧であるべきで、いきなり何かを実行してはいけない。先頭 recipe が default として走るので、そこに一覧表示を置く。

_default:
    @just --list

_ 始まりにするのは、この案内用 recipe 自身を just --list の一覧から隠すため。定義順が workflow 順を表すなら @just --list --unsorted でもよい。

2. recipe 名は verb / verb-noun kebab

recipe は「実行する動作」なので、名前は動詞で始めると just build のように命令として読める。関連する recipe は共通の動詞・名詞を prefix にして kebab-case でまとめる (db-migrate / db-generate、test-unit / test-e2e)。この prefix が緩い grouping も兼ねる。

例外は status / report を「見る」だけの recipe。これらは名詞のほうが自然に読める (doctor・status・ci・changelog)。動詞を無理に付けない。

3. 可変長引数は小文字 `*args` で pass-through

下位ツールにフラグをそのまま渡したいときは末尾に *args を置く。実測した OSS はすべて小文字 *args / +args。大文字 *ARGS は使わない (位置引数 server / version などと casing を揃えるため)。

# Run the test suite; extra flags pass through (e.g. just test -k slow)
test *args:
    pytest {{args}}

4. コメントは英語の 1 行 doc-comment

recipe 直上の # コメントは just --list にそのまま説明として表示される — つまり recipe の UI。英語で、命令形の短い 1 行にする ("Run the test suite"、"Deploy the API to production")。何をするかだけを書き、なぜその実装かの弁明は書かない (それは PR / コード側の管轄)。

5. `[group(...)]` は recipe が増えてから

grouping は just --list の見た目を整えるための presentation であって必須ではない。 recipe が数本のうちは group を付けず、増えて一覧が読みにくくなってから導入する。

[group('db')]
db-migrate:
    ...

大型でも group 属性を使わず # ---- db ---- のような section コメントだけで区切る OSS もある (oxc がこれ)。どちらでもよいが、片方に統一する。

手順

対象を把握する。新規なら実行したい動作を洗い出す。既存なら recipe を 1 本ずつ読み、名前・引数・default・コメントを上の 5 ルールに照合する
引数なし just で一覧が出るよう、先頭に private _default を置く (ルール 1)
各 recipe 名を verb / verb-noun kebab に直す。status / report 系だけ noun を許す (ルール 2)
下位ツールへ渡す可変長引数を小文字 *args に統一する (ルール 3)
各 recipe 直上に英語 1 行の doc-comment を付ける (ルール 4)
recipe 数を見て group の要否を判断し、使うなら [group(...)] かコメント section のどちらかに統一する (ルール 5)
提出前に「完了チェック」を 1 項目ずつ機械的に検査する

完了チェック

先頭に private な _default があり just --list を呼ぶ (裸の just が何も実行しない)
recipe 名が verb / verb-noun kebab。名詞は status / report 系だけ
可変長引数がすべて小文字 *args。大文字 *ARGS が 1 つもない
各 recipe 直上に英語 1 行の doc-comment がある
recipe が少数なら group なし。多いなら [group(...)] かコメント section の一方に統一
個人的な癖 (emoji の状態記号・罫線 divider・過剰な安全ガード) を持ち込んでいない