zoom-out — скилл для Claude Code: карта незнакомой области
Разбирает незнакомый участок кода с четырёх сторон и собирает из находок одну карту ориентирования.
npx skills add haowjy/creative-writing-skills --skill zoom-out -a claude-codeЧто делает zoom-out
Скилл включается, когда вы попадаете в незнакомую подсистему, подхватываете чужую работу или просто просите «сориентируй меня». Вместо одного прохода он запускает несколько независимых: структура (вызовы, зависимости, границы модулей, точки входа), записанные знания из базы, руководств и справочников, история решений и словарь предметной области. Каждый заход ограничен своим вопросом — один проход не должен закрывать два угла, потому что ценность именно в независимом покрытии.
Дальше находки сводятся в один документ, а не в четыре сшитых дампа: что это за область и где её границы, какие модули и интерфейсы важны и как связаны, почему всё сложилось именно так, какие термины нужны для точного разговора, что осталось незакрытым. Если форма пространственная, добавляется диаграмма mermaid. История решений пропускается, когда релевантных записей нет.
Скилл подгружает /qi-layer, если тот ещё не загружен, — это стоит проверить заранее, иначе первый запуск начнётся с лишнего шага. Противоречия между находками он разрешает, а не перечисляет: код считается истиной, а расходящийся с ним документ помечается как устаревший. Карта намеренно короткая — цель в том, чтобы читатель мог дальше ходить по области сам.
Какие задачи решает
- разобраться в незнакомой подсистеме перед первой правкой
- подхватить чужой код и понять, где что лежит
- собрать историю решений: почему сделано именно так
- выписать словарь терминов, которыми говорят о модуле
- найти незакрытые вопросы и долги в области
Примеры запросов агенту
- сориентируй меня в модуле платежей
- что тут вообще происходит, покажи карту области
- разберись, как устроен этот сервис, и объясни, почему он такой
Как установить zoom-out
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill zoom-out -a claude-code2Вручную: положить файлы
~/.claude/skills/zoom-out/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/zoom-out/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill zoom-out -a codex2Вручную: положить файлы
.agents/skills/zoom-out/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill zoom-out -a cursor2Вручную: положить файлы
.cursor/skills/zoom-out/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills zoom-out2Вручную: положить файлы
.github/skills/zoom-out/SKILL.md1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill zoom-out -a gemini-cli2Командой платформы
gemini skills install https://github.com/haowjy/creative-writing-skills --path cw/skills/zoom-outВручную: положить файлы
.devin/skills/zoom-out/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill zoom-out -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о zoom-out
Как установить zoom-out в Claude?
Выполните npx skills add haowjy/creative-writing-skills --skill zoom-out -a claude-code. Файл скилла окажется по пути ~/.claude/skills/zoom-out/SKILL.md.
Что делает zoom-out?
Разворачивает исследование незнакомой области по нескольким углам отдельно, а затем сводит результаты в одну карту ориентирования с границами, структурой, историей решений, словарём и открытыми вопросами.
Что нужно для работы zoom-out?
Скилл подгружает /qi-layer, если тот ещё не загружен, — проверьте это до первого запуска.
Исходный текст
SKILL.md · Apache-2.0
--- name: zoom-out description: Use when orienting in an unfamiliar area — fans out exploration across structure, knowledge, and history, then synthesizes one orientation map. --- # Zoom Out Load `/qi-layer` if it isn't already loaded. Orient in an unfamiliar area by exploring multiple angles — each covering a different lens — then synthesizing the findings into one orientation map. A single angle sees one slice; zoom-out covers structure *and* knowledge *and* history at once, so the picture isn't skewed by one lens. Use when starting in an unfamiliar subsystem, picking up someone else's work, or when the user says "orient me" / "what's the lay of the land here." ## Fan Out Explore each angle independently, scoped to one question each: - **Structure** — callers, dependencies, module boundaries, entry points, where behavior actually lives. - **Documented knowledge** — what's been written about this area in the KB, guides, and reference docs — architecture, patterns, synthesized research. - **Decision history** — why it's shaped this way — prior choices, rejected alternatives, constraints discovered. Skip when there's no relevant history. - **Domain concepts** — the vocabulary in use (KB vocab pages, project guides, context docs). Scope each exploration to its angle with concrete path or topic targets. Don't let one pass cover two angles — the value is independent coverage. ## Synthesize Read the findings and produce one orientation map, not four stitched-together dumps: - **What this is** — the area's purpose and boundaries, in two or three sentences. - **Structure** — the modules and interfaces that matter and how they connect (a mermaid diagram if the shape is spatial). - **Why it's like this** — the decisions and constraints that explain the current shape. - **Vocabulary** — the terms needed to speak about it precisely. - **Open threads** — gaps, debt, or unresolved questions surfaced. When findings contradict each other, resolve it rather than listing both — code is ground truth; a doc that disagrees is stale (note it). Keep the map tight: the goal is a reader who can now navigate the area, not an exhaustive transcript.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills