code-formatter

Code Formatter Skill

Apply consistent code formatting and style according to established guidelines.

Formatting Standards

File Naming

• All files: lowercase_with_underscores
• Examples: user_service.py, api_client.ts, data_helper.js

Variable Naming

• Variables/Functions: camelCase
• Classes/Components: PascalCase
• Constants: UPPER_CASE_SNAKE_CASE

// Good
const userName = 'John';
const API_KEY = 'secret';

class UserService {}
function getUserData() {}

// Bad
const UserName = 'John';
const api_key = 'secret';

class userService {}
function get_user_data() {}

Code Style

Line Length

• Maximum 100 characters per line
• Break long lines logically at operators or delimiters

Commas

• Use trailing commas for multi-line objects and arrays

// Good
const config = {
  host: 'localhost',
  port: 3000,
  timeout: 5000,  // trailing comma
};

const items = [
  'first',
  'second',
  'third',  // trailing comma
];

// Bad
const config = {
  host: 'localhost',
  port: 3000,
  timeout: 5000  // missing trailing comma
};

Imports

• Use explicit imports (no wildcard *)
• ES Modules only (no require)
• Group imports: external libraries first, then internal modules

// Good
import { useState, useEffect } from 'react';
import { fetchUser } from '../api/users';

// Bad
import * from 'react';
const users = require('../api/users');

Async/Await

• Prefer async/await over .then() chains

// Good
async function fetchData() {
  const response = await apiClient.get('/data');
  return response.data;
}

// Bad
function fetchData() {
  return apiClient.get('/data').then(res => res.data);
}

TypeScript Standards

• Enable strict mode
• Avoid any type (use unknown if type is truly unknown)
• Define interfaces for object shapes
• Use type annotations for function parameters and returns

// Good
interface User {
  id: number;
  name: string;
  email: string;
}

async function getUser(id: number): Promise<User> {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

// Bad
async function getUser(id) {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}