К основному содержанию
скилл CX Codex

file-headers — скилл для Claude Code: заголовки файлов и аудит

Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/file-headers/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/file-headers/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
security-headers-configuration aj-geddes Скилл security-headers-configuration настраивает HTTP-заголовки безопасности вроде CSP, HSTS и X-Frame-Options для веб-приложений. Защищает сервис от XSS, кликджекинга и MIME-сниффинга. CX Codex +1 522установок vercel-deployment-cursorrules-prompt-file PatrickJS Правило vercel-deployment-cursorrules-prompt-file для Cursor, которое подсказывает агенту, как готовить проект к деплою на Vercel. Задаёт структуру API-роутов, настройки vercel.json, работу с переменными окружения и кеширование. CX Codex +1 ★ 41 178звёзд репо include-what-you-use mohitmishra786 Скилл include-what-you-use ведёт агента через IWYU: разбирает отчёты, применяет mapping-файлы и убирает лишние #include, из-за которых сборка C++ расползается. CX Codex +1 580установок security-baseline rampstackco Скилл security-baseline для Claude Code задаёт базовый уровень защиты сайта или веб-приложения. Включается при настройке HTTPS, заголовков безопасности, CSP и секретов, а также перед запуском сайта. CX Codex +1 297установок agent-ready-link-headers fabricioctelles Скилл agent-ready-link-headers для Claude Code добавляет Link-заголовки ответов на главную страницу сайта. ИИ-агенты автоматически обнаруживают API и документацию. CX Codex +1 ★ 141звёзд репо HTTP Security Headers — HSTS, CSP, Score 0-100 axel-belfort MCP-сервер HTTP Security Headers — HSTS, CSP, Score 0-100 для Claude Code проверяет заголовки безопасности веб-адресов, находит пропущенные директивы и выставляет общую оценку. CX Codex +1 4 473установок

Из того же набора155

Весь набор →
trend-forecaster Субагент trend-forecaster оценивает будущие расходы и активность Claude Code по дневной статистике Agent Monitor. Помогает увидеть изменение тренда на горизонте до 30 дней. CX Codex ★ 1 198звёзд репо analytics-advisor Субагент analytics-advisor для Claude, который собирает цифры с дашборда Agent Monitor и объясняет, за что вы платите в сессиях. CX Codex ★ 1 198звёзд репо dashboard-operator Субагент dashboard-operator следит за состоянием панели Claude Code Agent Monitor на порту 4820, читает метрики и подсказывает шаги для запуска или импорта данных. CX Codex ★ 1 198звёзд репо reliability-engineer Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками. CX Codex ★ 1 198звёзд репо orchestration-analyst Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора. CX Codex ★ 1 198звёзд репо session-investigator Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев. CX Codex ★ 1 198звёзд репо db-inspector Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается. CX Codex ★ 1 198звёзд репо token-economist Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах. CX Codex ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой