prettier

# Prettier Formatter ## Purpose Detect Prettier presence in a repository and format code. This skill handles detection of configuration and commands, then executes formatting. Designed for use as the final cosmetic pass before committing changes. ## When to Use This skill should be invoked: - After all quality checks have passed (eslint, typescript) - Before committing changes - When purely cosmetic code formatting is needed This skill should NOT be invoked: - During active development (formatting may be overwritten) - Before quality checks (fixes may undo formatting) ## Detection Process ### Step 1: Check for Prettier Configuration Search for Prettier configuration files using Glob tool: - `.prettierrc` - `.prettierrc.json` - `.prettierrc.js` - `.prettierrc.yaml` - `.prettierrc.yml` - `prettier.config.js` - `prettier.config.cjs` - `package.json` (check for `prettier` field or dependency) If NO configuration found: - Set `prettierDetected: false` - Return early with JSON indicating not configured If configuration found: - Set `prettierDetected: true` - Proceed to Step 2 ### Step 2: Detect Format Command Search for format commands in priority order: #### 2a. Check CLAUDE.md (Highest Priority) If `CLAUDE.md` exists: - Read the file - Search for sections: "Formatting", "Development Commands", "Code Style" - Look for command patterns: `prettier`, `format`, `npm run format` - Extract exact command mentioned - Record CLAUDE.md as source if found #### 2b. Check package.json Scripts Read `package.json` and examine the `scripts` section: **Format commands** (look for these script names): - `"format"` - `"format:write"` - `"prettier"` - `"prettier:write"` - Extract as: `npm run <script-name>` Record package.json as source if found. #### 2c. Check Makefile If `Makefile` exists: - Search for targets containing `prettier` or `format` - Common target patterns: `format`, `prettier`, `fmt` - Extract as: `make <target-name>` - Record Makefile as source if found #### 2d. Fallback Command If no command found in any source: - Use fallback: `npx prettier --write .` - Record source as: `"fallback"` ### Step 3: Execute Formatting Run the detected format command: ```bash <detected-command> ``` Capture the output to determine files changed. ### Step 4: Build and Return JSON Response Construct JSON object with this structure: ```json { "prettierDetected": true, "configFile": ".prettierrc.json", "command": { "format": "npm run format", "source": "package.json" }, "result": { "status": "formatted", "filesChanged": 5, "message": "Formatted 5 files" } } ``` **Field Specifications:** - `prettierDetected` (boolean): `true` if config found, `false` otherwise - `configFile` (string): Path to detected config file - `command` (object): Format command details - `format` (string): Exact command executed - `source` (string): Where command was found - `result` (object): Execution results - `status` (string): `"formatted"`, `"no-changes"`, or `"not-configured"` - `filesChanged` (number): Count of files modified - `message` (string): Human-readable summary ## Output Format Return the JSON structure with a summary: ```markdown ## Prettier Format Results ```json { "prettierDetected": true, ... } ``` **Summary:** - Prettier detected: Yes/No - Files formatted: <count> - Command used: <command> ``` ## Edge Cases **No Prettier configuration found:** ```json { "prettierDetected": false, "configFile": null, "command": {}, "result": { "status": "not-configured", "filesChanged": 0, "message": "Prettier not configured in this repository" } } ``` **Prettier configured but no files changed:** ```json { "prettierDetected": true, "configFile": ".prettierrc", "command": { "format": "npm run format", "source": "package.json" }, "result": { "status": "no-changes", "filesChanged": 0, "message": "All files already formatted" } } ``` **Command execution error:** - Report the error in the result message - Set status to `"error"` - Include error details for troubleshooting --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/alex-popov-tech) — claim your Tome and manage your conversions. <!-- tomevault:4.0:skill_md:2026-04-11 -->