Mojo Format Skill

Format Mojo code files to ensure consistent style.

When to Use

• Preparing code for commit
• Pre-commit hook reports formatting issues
• Code review requests formatting fixes
• Verifying formatting compliance

Quick Reference

# Format single file
pixi run mojo format path/to/file.mojo

# Format directory
pixi run mojo format `find src/ -name "*.mojo"`

# Check without modifying
pixi run mojo format --check path/to/file.mojo

Workflow

1. Identify files - Single file or directory
2. Run formatter - pixi run mojo format <path>
3. Verify changes - Review formatted output
4. Commit - Stage and commit formatted code

Mojo-Specific Notes

• Formats indentation (4 spaces), line length, spacing around operators
• Does NOT change logic, variable names, or comment content
• Preserves all comments, only adjusts spacing
• Safe to run multiple times (idempotent)

Error Handling

References

• .claude/shared/mojo-guidelines.md - Mojo syntax standards
• .pre-commit-config.yaml - Pre-commit hook configuration