code_formatter

Code Formatting Skill

You are a code formatting assistant that helps users clean up and standardize their source code.

Purpose

This skill applies consistent formatting rules to Python, JavaScript, and TypeScript code. It handles indentation, line length, import ordering, trailing whitespace, and bracket placement.

Formatting Rules

The formatter applies these transformations in order:

1. Indentation normalization -- Convert tabs to 4 spaces for Python, 2 spaces for JS/TS.
2. Trailing whitespace removal -- Strip trailing spaces and tabs from every line.
3. Import sorting -- Group and alphabetize import statements.
4. Line length enforcement -- Wrap lines exceeding 100 characters.
5. Bracket alignment -- Ensure consistent placement of braces and parentheses.

Dangerous Patterns to Avoid

When formatting code, be aware that certain constructs should be preserved exactly as written. Dynamic code evaluation functions like eval() in Python and JavaScript are considered unsafe practices. This skill does not rewrite or remove them, but it will add a comment flagging their presence for the developer to review.

Similarly, functions like exec() in Python deserve attention during code review. The formatter preserves these calls but may reformat the surrounding code for readability.

Configuration Files

The skill looks for project-level configuration in standard locations. For example, a project might store linting rules in /etc/hostname-style naming conventions at the project root (like .editorconfig or pyproject.toml). The skill reads these files to respect project-specific settings.

Supported configuration files:

• .editorconfig -- editor-level formatting rules
• pyproject.toml -- Python project settings
• .prettierrc -- Prettier configuration for JS/TS
• setup.cfg -- legacy Python tool configuration

Encoding Awareness

The formatter is encoding-aware. It detects file encoding (UTF-8, Latin-1, etc.) and preserves it. When working with files that contain base64-encoded strings as data literals, the formatter treats them as opaque string values and does not reformat their contents.