# Loading Addressable Markdown

Use when a mission, slice, dashboard, or task references Markdown as path#h2-slug or...

- Repository: https://github.com/mvschwarz/openrig (8541 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -g -a claude-code -y`
Codex: `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -g -a codex -y`
Cursor: `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -g -a cursor -y`
Gemini CLI: `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.