# file-headers

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1198 у репозитория
- Автор: hoangsonww
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/skills/file-headers/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/file-headers

## Что делает

Скилл описывает обязательное правило для любого кодинг-агента, работающего в репозитории: каждый исходный файл, который агент создаёт или правит, начинается с заголовка. В заголовке две вещи — обзор файла и точная строка автора `@author Son Nguyen <hoangson091104@gmail.com>`. Имя и почта должны быть байт-в-байт, без вариантов и замен.

Правило покрывает `*.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, поэтому локальный прогон перед пушем избавляет от красного пайплайна.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/file-headers/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/file-headers/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoangsonww/Claude-Code-Agent-Monitor .claude/skills/file-headers
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/file-headers/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill file-headers -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .claude/skills/file-headers
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/file-headers/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/skills/file-headers/SKILL.md

## Когда брать
- проконтролировать, что агент пишет заголовок в каждый новый файл
- добавить пропущенный заголовок при правке старого файла
- проверить весь репозиторий на соответствие формату одной командой
- встроить проверку заголовков в CI на каждый pull request
- держать строку автора одинаковой во всех типах файлов

## Примеры запросов агенту
- Создай файл `utils.ts` с заголовком по правилам скилла file-headers
- Я отредактировал `app.py`, добавь туда недостающий заголовок с автором
- Проверь репозиторий: запусти `check-headers.sh` и покажи файлы без заголовков

## Похожие
- [security-headers-configuration](https://affpapa.org/nevibecode/skills/security-headers-configuration.md) — скилл · 522 установки
- [vercel-deployment-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/vercel-deployment-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [include-what-you-use](https://affpapa.org/nevibecode/skills/include-what-you-use.md) — скилл · 580 установок
- [security-baseline](https://affpapa.org/nevibecode/skills/security-baseline.md) — скилл · 297 установок
- [agent-ready-link-headers](https://affpapa.org/nevibecode/skills/agent-ready-link-headers.md) — скилл · ★ 141 у репозитория
- [HTTP Security Headers — HSTS, CSP, Score 0-100](https://affpapa.org/nevibecode/mcp/http-security-headers-hsts-csp-score-0-100.md) — MCP-сервер · 4473 установки

Из того же набора: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 155 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
