justfile-syntax

Enforce 4-space indentation and heredoc rules when editing Justfiles.

9|Updated Jan 31, 2017
One-click install
npx skills add https://github.com/ssiumha/dots --skill justfile-syntax
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: justfile-syntax
Source: https://github.com/ssiumha/dots/tree/main/prompts/skills/justfile-syntax
Command: npx skills add https://github.com/ssiumha/dots --skill justfile-syntax

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Justfile syntax and indentation rules ensure consistent, readable, and maintainable task files.

Core Features & Use Cases

  • 4-space indentation for recipes
  • Heredoc obedience (no indentation for content and EOF marker)
  • Variable substitution in heredoc and safe edge-cases
  • Timely examples of correct and incorrect formatting

Quick Start

Use this guide when editing Justfiles to ensure proper indentation and heredoc usage.

Frequently Asked Questions about justfile-syntax

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix indentation errors in Justfiles?

Justfile recipes require consistent indentation: use either 4 spaces or tabs for recipe lines. Heredoc content must start at column 0 with no indentation, and EOF markers must remain unindented. This Skill enforces these rules to prevent syntax errors and ensure recipes execute correctly.

What are the heredoc rules for Justfiles?

In Justfiles, heredoc blocks must have content starting at column 0 without indentation, and the EOF marker must also be unindented. Variable substitution is handled safely within heredocs. This Skill validates heredoc formatting to maintain syntax compliance.

Can I use variable substitution in Justfile heredocs?

Yes, Justfiles support variable substitution in heredoc blocks with safe edge-case handling. This Skill ensures substitution works correctly while maintaining proper heredoc structure and indentation rules for reliable task execution.

Why does my Justfile recipe fail with indentation issues?

Justfile syntax is strict about indentation: recipes need 4-space or tab indentation, while heredoc content and EOF markers require no indentation at column 0. This Skill identifies and fixes these anti-patterns to resolve syntax failures in Bash automation projects.

How do I validate Justfile formatting when editing recipes?

This Skill applies structure checks and editing validation for indentation, heredoc formatting, and variable handling across Justfile recipes. It enforces 4-space or tab indentation, validates heredoc obedience, and checks EOF marker placement during editing.

What indentation style should I use in Justfiles?

Justfiles accept either 4-space or tab indentation for recipe lines, but consistency is essential. This Skill enforces whichever style you choose and validates that heredoc content and EOF markers remain at column 0 without indentation.