Code Fmt

Code Formatting Skill

This skill provides code formatting operations for the tools workspace (cargo-nx + netloader).

When to Use This Skill

Use this skill when you need to:

• Format code after editing Rust files
• Check if code meets formatting standards
• Ensure code formatting compliance before commits

Command Selection Rules

This is a small 2-crate workspace. Always use the global format command:

Available Commands

Format Rust Code

just fmt

Formats all Rust code using cargo +nightly fmt --all. Nightly is required because rustfmt.toml uses unstable features (imports_granularity, group_imports).

Check Rust Formatting

just fmt-check

Checks Rust code formatting without making changes using cargo +nightly fmt --all -- --check.

Important Guidelines

Format Before Checks/Commit

Format code when you finish a coherent chunk of work and before running checks or committing.

This is a critical requirement from the project's development workflow:

• Do not skip formatting before checks/commit
• Run formatting before any check or test commands

Example Workflow

1. Edit Rust files
2. When ready to validate, run: just fmt
3. Then run checks (use /code-check skill)

Common Mistakes to Avoid

Anti-patterns

• Never run cargo fmt directly - Use just fmt (ensures nightly toolchain)
• Never run rustfmt directly - The justfile includes proper flags
• Never skip formatting before checks/commit - Even "minor" edits need formatting

Best Practices

• Format before running checks/tests or before committing
• Run just fmt-check to verify formatting before commits

Pre-approved Commands

These commands can run without user permission:

• just fmt - Safe formatting operation
• just fmt-check - Safe, read-only format check

Next Steps

After formatting your code:

1. Check compilation - Use /code-check skill
2. Run clippy - Use /code-check skill
3. Run tests when warranted - Use /code-test skill

Converted and distributed by TomeVault — claim your Tome and manage your conversions.