Skills

Loading Addressable Markdown

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

Install

npx skills add mvschwarz/openrig --skill loading-addressable-markdown -g -a claude-code -y
Repository
mvschwarz/openrig8.5k
Category
Engineering
Updated
3d ago
License
Apache-2.0
Context cost
Lightabout 290 tokens
Runs scripts
Yes, review before use

What it does

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.

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.

More in Engineering