New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Addressable Markdown Loader

by mvschwarz in mvschwarz/openrig

Loads one section of a Markdown file by its path#h2-slug address with a bundled resolver script, for use outside OpenRig's context library.

Apache-2.0Auto-check passedAgent Workflows

Install Addressable Markdown Loader

skills CLI
$ npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvschwarz/openrig loading-addressable-markdown --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvschwarz/openrig.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/daemon/assets/plugins/openrig-core/skills/loading-addressable-markdown .claude/skills/loading-addressable-markdown && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
loading-addressable-markdown
GitHub stars
5.5k
Token cost
~341 tokens
SKILL.md length
134 words
Files
2 (incl. scripts)
Skills in repo
49
Repo updated
First seen
Licence
Apache-2.0

At a glance

Loads one section of a Markdown file by its path#h2-slug address with a bundled resolver script, for use outside OpenRig's context library.

  • Reading one section referenced as path#h2-slug in a mission, slice or task
  • SKILL.md covers Overview, Use and Common mistakes
  • Runs JavaScript scripts from its folder; calls node
  • Pulling a single H3 section out of a spec file

What it does

A bundled Node script, `scripts/resolve-markdown.mjs`, returns exactly one addressed piece of a Markdown file from any folder tree. Addresses take three forms: `file.md` for the whole file, `file.md#h2-slug` for a full H2 section including its child sections, and `file.md#h2-slug/h3-slug` for a full H3 section. Relative paths resolve from the folder given with `--root`, or from the current directory if it is omitted.

Slugs are lowercase, with emphasis and code markers removed and each other run of non-alphanumeric characters turned into a hyphen. Missing paths and duplicate headings fail loudly, and headings inside fenced code blocks are ignored. The skill warns against using `rig context get`, which handles context-library references only, against slicing headings by hand with sed or line numbers, and reminds you to quote addresses in shell commands.

When your agent uses it

  • Reading one section referenced as path#h2-slug in a mission, slice or task
  • Pulling a single H3 section out of a spec file
  • Resolving Markdown references that live outside the context-pack library

Example prompts

  • “Load the proposal section from slices/09-source-cleanup/SPEC.md.”
  • “Resolve the markdown address docs/design.md#api/errors and show me that section.”
  • “Read the rollout section of the plan file from the mission folder, including its child sections.”

Requirements

  • Node to run the resolver script

What it can do on your machine

Read from SKILL.md and the folder at commit a7fed63. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Addressable Markdown Loader loads about 341 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 134 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~341

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from mvschwarz/openrig at commit a7fed63, republished under its Apache-2.0 licence (© mvschwarz). 134 words, ~341 tokens.

Download SKILL.mdSave it as .claude/skills/loading-addressable-markdown/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in packages/daemon/assets/plugins/openrig-core/skills/loading-addressable-markdown of mvschwarz/openrig.

  • SKILL.md
  • scripts/resolve-markdown.mjs

Open the folder on GitHubat commit a7fed63

Compare with similar skills

Addressable Markdown Loader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Addressable Markdown Loader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Addressable Markdown Loader this skillmvschwarz/openrig5.5k—~341Automated safety check: PassApache-2.0
Markdown Token OptimizerAzure/azure-sdk-tools134—~602Automated safety check: PassMIT
Markdown Token OptimizerAzure/azure-sdk-tools134—~494Automated safety check: PassMIT
Create SkillPINA-org/PINA797—~1.8kAutomated safety check: PassMIT
Writing Docsc15t/c15t1.9k—~872Automated safety check: PassApache-2.0
Dex Plandcramer/dex385—~3.2kAutomated safety check: PassMIT

Similar skills

  • Markdown Token Optimizer

    Azure/azure-sdk-tools

    Official

    Analyze markdown files for token efficiency and reduce context-window bloat.

    134 GitHub stars~602 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Markdown Token Optimizer

    Azure/azure-sdk-tools

    Official

    Analyze markdown files for token efficiency and reduce context-window bloat.

    134 GitHub stars~494 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Create Skill

    PINA-org/PINA

    Create, modify, and improve PINA skills. An agent skill from PINA-org/PINA.

    797 GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Writing Docs

    c15t/c15t

    Author or edit c15t documentation in docs//.mdx — the source for both the c15t.com site and the docs bundled into published packages.

    1.9k GitHub stars~872 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Dex Plan

    dcramer/dex

    Create dex task from markdown planning documents (plans, specs, design docs, roadmaps)

    385 GitHub stars~3.2k tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed

  • Planning

    championswimmer/pi-context-prune

    Create and execute phased implementation plans stored in .agents/plans using numbered markdown files with YAML front matter and checklist steps.

    245 GitHub stars~779 tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed

More from mvschwarz/openrig

All 49 skills in this repo

  • OpenRig Upgrade Procedure

    mvschwarz/openrig

    Walks an agent through upgrading the OpenRig CLI and daemon one observed step at a time, keeping live seats alive and reconciling managed plugin files.

    5.5k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

  • OpenRig Software Factory

    mvschwarz/openrig

    Helps set up a continuing agent software team for a real repository with OpenRig, choosing between manual work, queue handoffs and an explicit Workflow.

    5.5k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • Seat Continuity and Handover

    mvschwarz/openrig

    Separates a stable agent seat's identity from its changing occupant, and records honest, two-part provenance whenever one occupant replaces another.

    5.5k GitHub stars~2.1k tokensUpdated today
    Auto-check passed

  • Vault User

    mvschwarz/openrig

    A skill your agent uses when checking the health of this rig's HashiCorp Vault or writing, reading, listing, deleting or explaining its secrets.

    5.5k GitHub starsUsed in 1 repo~451 tokens
    Auto-check passed

  • Agent Refocusing

    mvschwarz/openrig

    Re-grounds a long-running agent in the current product outcome by running a path-based trace to the root of its topology and work trees.

    5.5k GitHub stars~399 tokensUpdated today
    Auto-check passed

  • Agent Starters

    mvschwarz/openrig

    Covers authoring, inspecting, refreshing, promoting and deprecating named Agent Starters, the reusable starting points for agent seats in a rig.

    5.5k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Addressable Markdown Loader

What does Addressable Markdown Loader do?

Loads one section of a Markdown file by its path#h2-slug address with a bundled resolver script, for use outside OpenRig's context library. mjs`, returns exactly one addressed piece of a Markdown file from any folder tree.md#h2-slug/h3-slug` for a full H3 section.

When should I use Addressable Markdown Loader?

Addressable Markdown Loader fits situations like: reading one section referenced as path#h2-slug in a mission, slice or task; pulling a single H3 section out of a spec file; resolving Markdown references that live outside the context-pack library.

How do I install Addressable Markdown Loader in Claude Code?

Run `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a claude-code`. Or copy the skill folder (packages/daemon/assets/plugins/openrig-core/skills/loading-addressable-markdown in mvschwarz/openrig) into .claude/skills/loading-addressable-markdown in your project. Claude Code loads it when a task matches its description.

How do I install Addressable Markdown Loader in Codex?

Run `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a codex`. Or copy the skill folder (packages/daemon/assets/plugins/openrig-core/skills/loading-addressable-markdown in mvschwarz/openrig) into .agents/skills/loading-addressable-markdown in your project. Codex loads it when a task matches its description.

Can I use Addressable Markdown Loader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvschwarz/openrig --skill loading-addressable-markdown -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/loading-addressable-markdown, .gemini/skills/loading-addressable-markdown, .github/skills/loading-addressable-markdown and .opencode/skills/loading-addressable-markdown in your project.

What does Addressable Markdown Loader need to run?

Going by SKILL.md and its folder, Addressable Markdown Loader needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node to run the resolver script.

Does Addressable Markdown Loader access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Addressable Markdown Loader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Addressable Markdown Loader use?

Addressable Markdown Loader is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Addressable Markdown Loader use?

About 341 tokens (SKILL.md is roughly 1.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Addressable Markdown Loader?

Skills that share tags, products or a category with Addressable Markdown Loader: Markdown Token Optimizer (Azure/azure-sdk-tools, 134 stars), Markdown Token Optimizer (Azure/azure-sdk-tools, 134 stars), Create Skill (PINA-org/PINA, 797 stars) and Writing Docs (c15t/c15t, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Addressable Markdown Loader?

mvschwarz (a GitHub user) maintains it in mvschwarz/openrig, which has 5,542 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.

Source: mvschwarz/openrig on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.