# Code Formatting

> Ensuring that code is well formatted Use when this capability is needed.

- Skill: `tomevault-io/code-formatting` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/code-formatting`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/code-formatting/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/code-formatting

---


# Code Formatting
_Ensuring that code is well formatted_

### Marking filenames for saving to file systems

**Filenames:**
*   Getting filenames correct is critical for ensuring that it will be saved
    into the right location in the codebase.  Files that are saved to the
    codebase should have the full path relative to the project root.
*   **Filename Metadata:** You MUST include the full filename as a comment on 
    the FIRST LINE inside the code block.
    Format: `# filename: path/to/file.ext`
*   **Shebangs:** For scripts requiring a shebang (e.g., `#!/bin/sh`), place 
    the filename comment on Line 1 and the shebang on Line 2. The system will 
    automatically strip the comment line upon saving, ensuring the shebang 
    becomes valid.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nick-orton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

