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

loading-addressable-markdown — скилл для Claude Code: адресные секции

Достаёт из дерева файлов ровно одну секцию Markdown по адресу вида file.md#h2-slug. Нужен, когда задача ссылается на раздел спецификации, а не на файл целиком.

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

Что делает 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-code

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

~/.claude/skills/loading-addressable-markdown/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
markdown-to-html официальный github Скилл объясняет агенту, как Markdown превращается в HTML: заголовки, таблицы, блоки кода, формулы. Пригодится, когда сайт или документация собираются из md-файлов. 9 899установок markdown-documentation aj-geddes Скилл задаёт агенту правила оформления Markdown: README, вики, страницы документации. Пригодится, когда тексты пишет модель и их надо привести к одному виду. CX Codex +1 1 300установок doc-to-markdown daymade Превращает DOCX, PDF, PPTX и сохранённый HTML в аккуратный Markdown и сам чинит типовые дефекты конвертации. Пригодится, когда нужно вытащить текст из документа без ручной правки. CX Codex +1 872установок qiaomu-markdown-proxy joeseesun Скилл преобразует веб-страницы, статьи WeChat, документы Feishu и файлы PDF в чистый Markdown перед передачей текста другим агентам. CX Codex +1 659установок obsidian-markdown AgriciDaniel Скилл объясняет, черновики и проверяет синтаксис Obsidian Flavored Markdown: свойства, wikilinks, вставки, callouts, теги, блоки, математику и Mermaid. CX Codex +1 545установок verifying-markdown-formatting spencerpauly Скилл проходит по Markdown-файлу чек-листом и правит форматирование: заголовки, списки, ссылки, код-блоки, пробелы. Пригодится перед коммитом README или документации. CX Codex +1 404установок

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

session-compaction-and-restore Скилл для тех, кто думает, что переживёт компакцию, рестарт и смену места: помогает не потерять рабочий контекст и намерение задачи. CX Codex +1 ★ 8 172звёзд репо openrig-user Скилл-справочник по CLI rig: подсказывает точный синтаксис команд, форму JSON, значения по умолчанию и смысл ошибок, когда команда уже известна. CX Codex +1 ★ 8 172звёзд репо claude-compaction-restore Помогает не потерять связи между файлами и решениями после компакции контекста: перед сжатием пишется карта восстановления, после — сессия перечитывает её и собирает картину заново. CX Codex +1 ★ 8 172звёзд репо agent-operated-software Скилл для проектирования и отладки приложений, где агенты OpenRig работают в живом бэкенде или контуре управления. CX Codex +1 ★ 8 172звёзд репо context-engineering Скилл про то, как наполняется окно контекста агента: что грузить сразу, что по запросу, когда чистить. Пригодится, если агент забывает ограничения посреди задачи. CX Codex +1 ★ 8 172звёзд репо orchestration-team Скилл для оркестрации: раздаёт задания между агентами, следит за простаивающими и заблокированными и не даёт оркестратору делать работу за других. CX Codex +1 ★ 8 172звёзд репо requirements-writer Ведёт диалог с продакт-менеджером и собирает из черновых мыслей один SPEC.md с проверяемыми критериями приёмки и явными границами. CX Codex +1 ★ 8 172звёзд репо exec-summary Собирает из папки фичи один документ на 600–800 слов: питч для продаж, стратегию для руководства и поведение для разработки. CX Codex +1 ★ 8 172звёзд репо

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

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