loading-addressable-markdown — скилл для Claude Code: адресные секции
Достаёт из дерева файлов ровно одну секцию Markdown по адресу вида file.md#h2-slug. Нужен, когда задача ссылается на раздел спецификации, а не на файл целиком.
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a claude-codeЧто делает loading-addressable-markdown
Скилл разбирает адрес file.md#h2-slug или file.md#h2-slug/h3-slug и возвращает весь спан заголовка вместе с дочерними секциями. Слаг приводится к нижнему регистру, разметка выделения и кода из заголовка убирается, каждый блок неалфанумерических символов схлопывается в -. Заголовки внутри блоков кода игнорируются, поэтому примеры в тройных кавычках не собьют разбор.
Работает через встроенный скрипт scripts/resolve-markdown.mjs. Относительные пути считаются от --root, без него — от текущей директории. Дубликаты и несуществующие пути роняют разбор с ошибкой, тихо ничего не подставляется. Адрес в шелле берите в кавычки, иначе # уйдёт в комментарий.
Команда rig context get для произвольного пути на диске не подойдёт: она разрешает ссылки библиотеки контекстов. Резать заголовки вручную через sed или по номерам строк тоже не стоит — поведение спанов и код-фенсов держит на себе резолвер.
Какие задачи решает
- вытащить одну секцию SPEC.md по слагу заголовка
- прочитать H3 внутри нужного H2, не открывая весь файл
- сослаться на раздел спецификации в задаче агента
- проверить, что адрес не дублируется и файл существует
- разобрать заголовки, не спотыкаясь о примеры в блоках кода
Примеры запросов агенту
- загрузи секцию
slices/09-source-cleanup/SPEC.md#proposal - прочитай
docs/SPEC.md#api/errorsи покажи содержимое - разреши адрес
SPEC.md#proposalот корня миссии
Как установить loading-addressable-markdown
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a claude-code2Вручную: положить файлы
~/.claude/skills/loading-addressable-markdown/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/loading-addressable-markdown/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a codex2Вручную: положить файлы
.agents/skills/loading-addressable-markdown/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a cursor2Вручную: положить файлы
.cursor/skills/loading-addressable-markdown/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mvschwarz/openrig loading-addressable-markdown2Вручную: положить файлы
.github/skills/loading-addressable-markdown/SKILL.md1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a gemini-cli2Командой платформы
gemini skills install https://github.com/mvschwarz/openrig --path packages/daemon/assets/plugins/openrig-core/skills/loading-addressable-markdownВручную: положить файлы
.devin/skills/loading-addressable-markdown/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о loading-addressable-markdown
Как установить loading-addressable-markdown в Claude?
Выполните npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a claude-code. Скилл встанет в ~/.claude/skills/loading-addressable-markdown/SKILL.md.
Что делает loading-addressable-markdown?
Загружает одну адресную секцию Markdown из любого дерева файлов по грамматике H2/H3, не требуя, чтобы файл лежал в библиотеке контекстов OpenRig.
Чем это отличается от rig context get?
rig context get разрешает ссылки библиотеки контекстов. Для произвольного пути на диске нужен этот резолвер — он сам владеет спанами и поведением код-фенсов.
Исходный текст
SKILL.md · Apache-2.0
--- name: loading-addressable-markdown description: Use when a mission, slice, dashboard, or task references Markdown as path#h2-slug or path#h2-slug/h3-slug outside the OpenRig context-pack library. --- # Loading Addressable Markdown ## Overview Load exactly one addressed Markdown section from any filesystem tree. The resolver mirrors OpenRig's shipped H2/H3 grammar without requiring the file to live in the context library. ## Use Run the bundled script. Relative file references resolve from `--root`; without it they resolve from the current directory. ```bash node ~/.agents/skills/loading-addressable-markdown/scripts/resolve-markdown.mjs \ --root /path/to/mission \ 'slices/09-source-cleanup/SPEC.md#proposal' ``` The accepted forms are: - `file.md` — whole file - `file.md#h2-slug` — full H2 span, including child sections - `file.md#h2-slug/h3-slug` — full H3 span Slugs are lowercase; Markdown emphasis/code markers are removed; each other non-alphanumeric run becomes `-`. Duplicate or missing paths fail loudly. Headings inside fenced code blocks are ignored. ## Common mistakes - Do not use `rig context get` for an arbitrary filesystem path; that command resolves context-library refs. - Do not hand-slice headings with `sed` or line numbers; the bundled resolver owns span and fence behavior. - Quote addresses in shell commands.
© mvschwarz · Apache-2.0 · mvschwarz/openrig