AgentSkillsCN

mojo-format

使用 mojo format 命令对 Mojo 代码进行格式化。适用于在准备提交代码时使用，或在格式化检查失败时使用。

SKILL.md
--- frontmatter
name: mojo-format
description: "Format Mojo code using mojo format command. Use when preparing code for commit or when formatting checks fail."
mcp_fallback: none
category: mojo

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

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

# Format directory
pixi run mojo format `find scylla/ -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

ErrorCauseSolution
Syntax errorInvalid Mojo syntaxFix syntax before formatting
File not foundWrong pathVerify file exists
Permission deniedFile permissionsCheck chmod settings
Mojo not installedMissing MojoInstall via pixi or Magic

References

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