file-headers — скилл для Claude Code: заголовки файлов и аудит
Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории.
MIT ★ 1 198 обновлён 2026-10-23
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a claude-codeЧто делает file-headers
Скилл описывает обязательное правило для любого кодинг-агента, работающего в репозитории: каждый исходный файл, который агент создаёт или правит, начинается с заголовка. В заголовке две вещи — обзор файла и точная строка автора @author Son Nguyen <[email protected]>. Имя и почта должны быть байт-в-байт, без вариантов и замен.
Правило покрывает *.js, *.ts, *.tsx, *.cjs, *.mjs, *.py, *.sh и *.css. Исключены node_modules/, dist/, build/, data/, снапшоты, локфайлы, JSON/YAML/Markdown, минифицированные и сгенерированные файлы. Формат заголовка зависит от типа: для JS/TS это блок-комментарий с @file и @author, для Python — строка в докстринге модуля, для shell — комментарий после shebang.
Отдельная часть — скрипт проверки. bash .claude/skills/file-headers/scripts/check-headers.sh выводит все файлы без заголовка и возвращает код 0, если всё чисто, или 1, если есть нарушения. Для pull request есть вариант check-headers-pr.sh, который смотрит только изменённые в PR файлы. Его же гоняет GitHub Actions на каждом PR, поэтому локальный прогон перед пушем избавляет от красного пайплайна.
Какие задачи решает
- проконтролировать, что агент пишет заголовок в каждый новый файл
- добавить пропущенный заголовок при правке старого файла
- проверить весь репозиторий на соответствие формату одной командой
- встроить проверку заголовков в CI на каждый pull request
- держать строку автора одинаковой во всех типах файлов
Примеры запросов агенту
- Создай файл
utils.tsс заголовком по правилам скилла file-headers - Я отредактировал
app.py, добавь туда недостающий заголовок с автором - Проверь репозиторий: запусти
check-headers.shи покажи файлы без заголовков
Как установить file-headers
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a claude-code2Вручную: положить файлы
~/.claude/skills/file-headers/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/file-headers/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a codex2Вручную: положить файлы
.agents/skills/file-headers/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a cursor2Вручную: положить файлы
.cursor/skills/file-headers/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor .claude/skills/file-headers2Вручную: положить файлы
.github/skills/file-headers/SKILL.md1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a gemini-cli2Командой платформы
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .claude/skills/file-headersВручную: положить файлы
.devin/skills/file-headers/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о file-headers
Как установить file-headers в Claude Code?
Выполни npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a claude-code. Скилл попадёт в ~/.claude/skills/file-headers/SKILL.md.
Что делает file-headers?
Заставляет кодинг-агента добавлять заголовок с обзором файла и строкой автора в каждый подходящий исходный файл, который он создаёт или изменяет. Правило действует автоматически, без отдельной просьбы.
Какие файлы считаются подходящими?
JS, TS, TSX, CJS, MJS, Python, shell и CSS. Не трогаются node_modules/, dist/, build/, data/, снапшоты, локфайлы, JSON/YAML/Markdown, минифицированные и сгенерированные файлы.
Исходный текст
SKILL.md · MIT
--- name: file-headers description: MANDATORY for every coding agent (Claude Code, Codex, or any other) on every change-set — every applicable source file the agent creates or updates MUST start with the project's copyright/authorship header (file overview + exact author line). Use automatically whenever writing a new file or editing an existing one; do not wait to be asked. Covers JS/TS/TSX/CJS/MJS, Python, shell, and CSS. Includes the audit script to verify repo-wide compliance. --- # File Headers — Copyright Comment + File Overview Every applicable source file in this repository starts with a header comment containing a **file overview** and the **exact author line**: ``` @author Son Nguyen <[email protected]> ``` The name and email must be exactly as above — no variations, no substitutions, no other names. This applies to **every coding agent** working in this repo (Claude Code, Codex, or any other tool): when you **create** a new applicable file, write the header first; when you **update** an existing applicable file that is missing the header, add it as part of the same change. ## Applicable files | Included | Excluded | | -------- | -------- | | `*.js`, `*.ts`, `*.tsx`, `*.cjs`, `*.mjs` | anything under `node_modules/`, `dist/`, `build/`, `data/`, `.worktrees/` | | `*.py`, `*.sh` | vendored/minified files (`*.min.js`, `wiki/mermaid.min.js`) | | `*.css` | generated files (`wiki/i18n-content.js` — carries its own AUTO-GENERATED banner) | | | snapshots (`__snapshots__/`), lockfiles, JSON/YAML/Markdown | ## Header formats by file type **JS / TS / TSX — server & scripts style** (overview inline in `@file`): ```js /** * @file One-to-few-sentence overview of what this file does and why it * exists. Mention the key contracts or invariants the file owns. * @author Son Nguyen <[email protected]> */ ``` **JS / TS / TSX — client style** (`@file` name + `@description` overview), used under `client/src/`: ```ts /** * @file ComponentName.tsx * @description What the component/module renders or provides and how it fits * into the app. * @author Son Nguyen <[email protected]> */ ``` **CSS** (same block-comment shape as `client/src/index.css`): ```css /** * @file file.css * @description What these styles cover. * @author Son Nguyen <[email protected]> */ ``` **Shell** (`#` block right after the shebang; existing overview comments count — just make sure the `@author` line is in the block): ```bash #!/usr/bin/env bash # script-name.sh — what the script does, one to few lines. # @author Son Nguyen <[email protected]> ``` **Python** (inside the module docstring): ```python """ module.py — what the module does. @author Son Nguyen <[email protected]> """ ``` ## Rules 1. **New file → header first.** Any applicable file you create starts with the header before any code (after the shebang for scripts). 2. **Touched file missing header → add it.** If you edit a file that lacks the header, add one in the same commit. Write a real overview — describe what the file actually does; never a placeholder like "TODO" or "utility file". 3. **Exact author line.** `@author Son Nguyen <[email protected]>` — byte-exact, in every file type (shell and Python use it inside `#` / docstring comments). 4. **Don't churn existing headers.** If a file already has a compliant header, leave it alone unless the file's purpose changed (then update the overview). 5. **Overviews must stay truthful.** When an edit changes what a file does, update its `@file`/`@description` overview in the same change. ## Audit Run the bundled checker to list any applicable file missing the header: ```bash bash .claude/skills/file-headers/scripts/check-headers.sh ``` Exit code `0` = fully compliant; `1` = the printed files are missing headers. Run it before finishing any change-set that adds files, and during reviews. On every pull request, GitHub Actions runs `.claude/skills/file-headers/scripts/check-headers-pr.sh` against only the files changed in the PR diff (added, copied, renamed, or modified). Test locally before pushing: ```bash bash .claude/skills/file-headers/scripts/check-headers-pr.sh origin/master HEAD ```
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor