Justfile in Nix projects

SkillDocs & knowledge

Lets your agent write justfile recipes that follow Nix project conventions like doc comments and devshell detection.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Justfile in Nix projects skill

About this capability

Conventions for writing justfile recipes in Nix-based projects.

What this skill tells your AI

The instructions your AI receives, as published by srid/emanote in .agents/skills/nix-justfile/SKILL.md and read by ahel’s review.

Doc comments

Every recipe must have a doc comment (# line above the recipe name).

Devshell detection

Use a nix_shell variable to auto-detect whether we're inside nix develop:

nix_shell := if env('IN_NIX_SHELL', '') != '' { '' } else { 'nix develop -c' }

Prefix commands that need devshell tools (node, trunk, cargo-watch, etc.) with {{nix_shell}}. Recipes that invoke nix directly (build, run, flake commands) don't need it.

Legibility

Long chained commands should use multiline \ continuations.

Signals

GitHub stars
958
Forks
79
Last commit
Jul 2026

ahel recommends instead

Advanced
Catalog kind
skill
Gateway key
nix-justfile-2
Source
github.com/srid/emanote