Code Format Skill

Format and validate code in various languages.

When to Use

✅ USE this skill when:

• "Format this Python code"
• "Validate this JSON"
• "Pretty print this JavaScript"
• "Format this Markdown"

When NOT to Use

❌ DON'T use this skill when:

• Linting code → use linters directly
• Compiling code → use compilers
• Minifying code → use minifiers

Supported Languages

Language	Formatter	Notes
Python	black, autopep8	Falls back to auto-format
JavaScript	prettier	If installed
TypeScript	prettier	If installed
JSON	python	Built-in
YAML	pyyaml	If installed
Markdown	prettier	If installed
HTML	prettier	If installed
CSS	prettier	If installed
SQL	sqlparse	If installed
Shell	shfmt	If installed

Commands

Format Code

{baseDir}/format-code.sh <file>
{baseDir}/format-code.sh <file> --language python
{baseDir}/format-code.sh --stdin --language js < code.js

Validate Syntax

{baseDir}/validate-code.sh <file>
{baseDir}/validate-code.sh <file> --language python
{baseDir}/validate-code.sh --stdin --language json < data.json

List Languages

{baseDir}/format-code.sh --languages

Options

• --language <lang>: Specify language (auto-detect from extension)
• --stdin: Read from stdin
• --out <file>: Write to file (default: stdout)
• --check: Check if formatting needed (don't modify)
• --diff: Show diff instead of formatted output
• --indent <n>: Indentation size (default: language-specific)

Examples

Format Python file:

{baseDir}/format-code.py script.py

Format JSON from stdin:

cat data.json | {baseDir}/format-code.sh --stdin --language json

Check if formatting needed:

{baseDir}/format-code.sh script.py --check
# Exit 0 if formatted, 1 if needs formatting

Format with custom indent:

{baseDir}/format-code.sh config.json --indent 4

Validate code:

{baseDir}/validate-code.sh script.py
# Output: ✓ Valid Python syntax

Notes

• Uses standard formatters when available
• Falls back to built-in formatters
• Does not modify files by default
• Use --out to save to same or different file