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

qi-layer · haowjy, claude — скилл для Claude Code: что делает и как установить

Скилл qi-layer задаёт правила описания контекста и ролей агентов в файлах AGENTS.md и .context/CONTEXT.md. Включается при настройке и поддержке системных инструкций проекта.

Apache-2.0 441 установок ★ 601 обновлён 2026-10-25

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

Что делает qi-layer

Этот скилл помогает структурировать файлы AGENTS.md и .context/CONTEXT.md, которые агенты читают при работе с кодом. Он направляет автора в выборе информации, чтобы инструкции оставались краткими и не перегружали сессию.

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

Файлы AGENTS.md и .context/ располагаются в одной директории, а структура данных сжимается по мере движения к корню репозитория. При использовании убедитесь, что в директории нет CLAUDE.md, так как приоритет чтения настроен на AGENTS.md.

Какие задачи решает

  • сократить системные промпты в репозитории
  • связать инструкции для агентов с контекстом проекта
  • убрать лишние сведения из файлов AGENTS.md
  • организовать архитектурные описания в .context/

Примеры запросов агенту

  • Проверь AGENTS.md в текущей папке через qi-layer
  • Обнови CONTEXT.md, используя логику qi-layer
  • Сформируй структуру для нового модуля по правилам qi-layer

Как установить qi-layer

1Через Skills CLI (Vercel)

npx skills add haowjy/creative-writing-skills --skill qi-layer -a claude-code

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

~/.claude/skills/qi-layer/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о qi-layer

Как установить qi-layer в Claude Code?

Выполните команду npx skills add haowjy/creative-writing-skills --skill qi-layer -a claude-code.

Что делает qi-layer?

Он помогает правильно составлять файлы AGENTS.md и .context/CONTEXT.md, чтобы агенты получали важную информацию для работы без избыточных данных.

Зачем нужно следить при работе с qi-layer?

Следите за отсутствием файлов CLAUDE.md, так как их наличие отменяет автоматическую загрузку AGENTS.md.

Исходный текст

SKILL.md · Apache-2.0
---
name: qi-layer
description: 'Use when writing or maintaining AGENTS.md or .context/CONTEXT.md: AGENTS.md loads automatically, so it keeps only what matters most.'
metadata:
  type: reference
---

# qi-layer

How to write the colocated pair, `AGENTS.md` and `.context/CONTEXT.md`, in
any tree agents work in: code, a KB, docs, a work directory.

## Writing AGENTS.md

`AGENTS.md` is loaded automatically: the root one into every session, a
nested one when an agent works in its directory, on harnesses that load
nested files. Codex loads only the files from the root down to where it
started, so the root tells agents to read an area's `AGENTS.md` before
changing that area. Write instructions there, not in a `CLAUDE.md`: Claude reads
`AGENTS.md` only when no `CLAUDE.md` sits in the directory or above it. Every line costs every
agent that works there, every time, so it holds only the most important
information: what must an agent understand before working here? Write it
like a prompt, as short as the directory allows, rarely past 200 lines.
Write a nested file as the local additions an agent needs on entry.

Put in only what an agent can't work out by reading the code: what the area
is for and, at the root, who its users are and what they rely on; the
commands that check work here; places where the code misleads (a live
directory that looks dead, a pattern new code must not copy); choices that
aren't visible in the code; mistakes agents have made here more than once;
and links to `.context/` and related areas. An agent that reads only
`AGENTS.md` should work correctly here; one that also reads `.context/`
should change things safely.

The tree compresses as it climbs. A leaf summarizes its directory, a parent
its children, and shared knowledge appears once, at the shallowest directory
covering every place it applies. Agents accumulate the tree as they descend,
so a child never repeats its parent.

## Writing .context/

`.context/CONTEXT.md` holds the depth an agent looks up before editing:
contracts and what breaks if they're violated, architecture and dependency
direction, rationale, concrete pitfalls. Add files beside it for specialized
concerns.

## What Doesn't Belong in AGENTS.md

Test each line: would removing it cause a wrong decision here? Text an agent
would only have to look up goes in `.context/`; text that changes nothing
gets deleted. Detail that matters in one domain goes in that domain's
directory, not the root.

- **Session bleed:** working notes that calcified into instructions: status
  words ("shipped", "deferred"), history, decision IDs, implementation terms
  with no framing.
- **Overviews:** architecture, file layout, tables of modules or fields,
  full vocabularies. The agent reads the repo itself; depth it has to look
  up goes in `.context/` or the code's own docs.
- **Procedures some runs need:** releasing, migrations, a review checklist.
  They go in a doc or skill the file links to.
- **Rules that can't have exceptions:** make them a hook, deny rule or CI
  check. A prose rule is followed almost always, not always, and emphasis
  (ALL CAPS, IMPORTANT) makes the model over-apply it.
- **Guards a check already enforces:** the test, type or lint is the guard;
  prose beside it rots.
- **Copies** of what a skill, another `.context/`, or a KB page says. Link
  to it.

## Structure

- Relative links, to files rather than headings.
- `AGENTS.md` and `.context/` sit side by side in the same directory.
- Link across `.context/` directories that share a contract.

© haowjy · Apache-2.0 · haowjy/creative-writing-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — qi-layer от других авторов.

qi-layer haowjy Скилл qi-layer задаёт правила, по которым агент пишет и поддерживает AGENTS.md и .context/CONTEXT.md, чтобы инструкции оставались короткими и рабочими. CX Codex +1 441установок intent-layer crafter-station Скилл intent-layer раскладывает контекст по папкам: корневой AGENTS.md плюс дочерние узлы, чтобы агент понимал код как старший инженер. CX Codex +1 639установок context-layer-health-check PostHog Скилл context-layer-health-check для Claude Code проверяет качество контекстной вики после объединения изменений. Разбирает пропуски, противоречия и устаревшие приоритеты. CX Codex +1 150установок developer-relations-kickoff Samuel Berthe Скилл developer-relations-kickoff для Claude Code направляет задачи по developer relations к подходящему скиллу коллекции или сообщает, что подходящего нет. При старте проекта он создаёт или обновляет общий файл контекста. CX Codex +1 13 900установок audit jsmastery-pro Скилл audit сканирует проект и создаёт файлы AGENTS.md для контекста ИИ-агентов. Помогает описать правила кодовой базы с нуля или дополнить пропущенные зоны. CX Codex +1 5 100установок sync jsmastery-pro Скилл sync доводит AGENTS.md, scope и статусы спек до состояния репозитория после готового изменения. Работает в Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode. CX Codex +1 5 000установок deepinit Yeachan-Heo Скилл deepinit проходит по дереву репозитория и кладёт в каждую папку AGENTS.md: что там лежит, как связаны части и что агенту знать перед правками. CX Codex +1 1 100установок

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

Весь набор →
information-hierarchy Скилл information-hierarchy для больших человекочитаемых материалов: отчётов, документации, многосекционных объяснений. Ответ идёт первым, глубина — за ним. CX Codex +1 456установок zoom-out Скилл zoom-out запускает параллельных «исследователей» по разным углам незнакомой области и собирает их отчёты в одну карту: структура, знания, история решений. CX Codex +1 443установок zoom-out Скилл zoom-out для Claude Code помогает освоиться в незнакомой части проекта. Он собирает карту структуры, знаний и истории решений по запросу сориентировать в коде. CX Codex +1 443установок structured-artifact Скилл structured-artifact для сборки структурированных HTML-артефактов: помогает агенту решить, как подать материал, и только потом выбрать инструменты. CX Codex +1 443установок knowledge-layers Скилл knowledge-layers для Claude Code распределяет знания проекта между локальной документацией, базой знаний и рабочими папками. Активируется при чтении или записи постоянной документации и выборе места для новых сведений. CX Codex +1 441установок md-validation Скилл md-validation для Claude Code проверяет ссылки в Markdown и синтаксис Mermaid. Запускайте его после правок документации, до коммита. CX Codex +1 441установок md-validation Скилл md-validation для Claude Code проверяет ссылки в Markdown и диаграммы Mermaid. Он включается по запросу проверить ссылки или Mermaid перед сдачей материала. CX Codex +1 441установок knowledge-layers Скилл knowledge-layers для Claude Code решает, в какой слой проекта писать знание: AGENTS.md, .context/, KB, docs/ или рабочий каталог. Устраняет путаницу агента при поиске контекста. CX Codex +1 441установок

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

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