qi-layer · haowjy, claude — скилл для Claude Code: что делает и как установить
Скилл qi-layer задаёт правила описания контекста и ролей агентов в файлах AGENTS.md и .context/CONTEXT.md. Включается при настройке и поддержке системных инструкций проекта.
Apache-2.0 441 установок ★ 601 обновлён 2026-10-25
npx skills add haowjy/creative-writing-skills --skill qi-layer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/qi-layer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qi-layer/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill qi-layer -a codex2Вручную: положить файлы
.agents/skills/qi-layer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill qi-layer -a cursor2Вручную: положить файлы
.cursor/skills/qi-layer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills plugin/claude/skills/qi-layer2Вручную: положить файлы
.github/skills/qi-layer/SKILL.md1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill qi-layer -a gemini-cli2Командой платформы
gemini skills install https://github.com/haowjy/creative-writing-skills --path plugin/claude/skills/qi-layerВручную: положить файлы
.devin/skills/qi-layer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill qi-layer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.