# qi-layer

Скилл задаёт правила, по которым агент пишет и поддерживает AGENTS.md и .context/CONTEXT.md, чтобы инструкции оставались короткими и рабочими.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 385 установок · ★ 541
- Автор: haowjy
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/haowjy/creative-writing-skills/tree/HEAD/cw/skills/qi-layer/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/qi-layer

## Что делает

AGENTS.md агент читает раньше всего остального в дереве, поэтому каждая строка там должна нести нагрузку. Скилл предлагает четыре принципа: фрактальное сжатие (листовой файл описывает свою папку, родительский — детей), иерархическое суммирование, дедупликацию по ближайшему общему узлу и постепенное раскрытие через ссылки на `.context/CONTEXT.md`.

Для AGENTS.md скилл советует держать объём редко выше 200 строк и включать только то, что имеет содержание: назначение области, ментальную модель, ключевые правила, антипаттерны и ссылки вниз. В `.context/CONTEXT.md` уходят контракты, архитектура, обоснования решений и паттерны работы. Отдельный раздел разбирает, чего в AGENTS.md быть не должно: заметок о ходе работы, справочных таблиц, предупреждений о том, что и так проверяют тесты или типы, и повторов того, что уже лежит в другом месте.

Про CLAUDE.md правило простое: Claude читает AGENTS.md, если рядом нет CLAUDE.md, поэтому отдельный файл нужен только под специфичные для Claude инструкции, и первой строкой в нём идёт `@AGENTS.md`. Общие указания в CLAUDE.md писать не стоит. Скилл ссылается на `/qi-maintenance` и `/knowledge-layers`, так что для полной картины их придётся поставить отдельно.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill qi-layer -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/qi-layer/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/qi-layer/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill qi-layer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill qi-layer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install haowjy/creative-writing-skills qi-layer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill qi-layer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/haowjy/creative-writing-skills --path cw/skills/qi-layer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill qi-layer -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/haowjy/creative-writing-skills/tree/HEAD/cw/skills/qi-layer/SKILL.md

## Когда брать
- написать AGENTS.md, который агент прочитает и не утонет в деталях
- разложить знание по уровням дерева без повторов
- отделить инструкции от справочного материала
- решить, нужен ли в проекте CLAUDE.md поверх AGENTS.md
- убрать из файла инструкций заметки о ходе работы

## Примеры запросов агенту
- напиши AGENTS.md для папки `src/api` по принципам qi-layer
- проверь корневой AGENTS.md: что здесь лишнее и что перенести в `.context/CONTEXT.md`
- нужен ли в этом проекте CLAUDE.md, если уже есть AGENTS.md

## Похожие
- [intent-layer](https://affpapa.org/nevibecode/skills/intent-layer.md) — скилл · 627 установок
- [sync](https://affpapa.org/nevibecode/skills/sync.md) — скилл · 4300 установок
- [audit](https://affpapa.org/nevibecode/skills/jsmastery-pro-audit.md) — скилл · 4300 установок
- [deepinit](https://affpapa.org/nevibecode/skills/deepinit.md) — скилл · 1000 установок
- [agents-md-generator](https://affpapa.org/nevibecode/skills/agents-md-generator.md) — скилл · 377 установок
- [claude-md](https://affpapa.org/nevibecode/skills/luongnv89-claude-md.md) — скилл · ★ 45153

Из того же набора: [haowjy/creative-writing-skills](https://affpapa.org/nevibecode/by/haowjy/creative-writing-skills.md) — 22 карточки

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

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