Agent skill - MyST Sites as Skills

This package bundles a simple agent skill at skills/docslice/SKILL.md. It is a lightweight guide that teaches an LLM to use docslice for retrieval from MyST documentation.

The skill is included below verbatim:

SKILL.md

---
name: docslice
description: Read any deployed MyST documentation site from the command line, one section at a time. Use when you need content from a MyST site (MyST guide, Jupyter Book sites, and similar) without fetching and parsing whole pages.
---

# docslice

`docslice` pulls sections out of any deployed MyST site as markdown.
Use it for progressive disclosure: survey a site cheaply, then read only the sections you actually need, already converted to markdown.
Never fetch and parse whole pages of a MyST site when this tool is available.

If `docslice` isn't on your PATH, run it as `npx docslice`, or from a checkout of this repo as `npx tsx src/cli.ts`.

## The loop

Survey, locate, retrieve.
On an unfamiliar site, start with `docslice get <site-root>` to learn what the site is about, then:

```bash
docslice outline <site>            # list the site's pages
docslice outline <site> <page>     # list one page's headings and anchors
docslice search <site> "<phrase>"  # find sections mentioning a phrase
docslice get '<url>#<anchor>'      # print that section as markdown
```

Addresses are plain URLs: `search` and `outline` print `url#anchor` values that feed straight into `get`.
The anchor can be any MyST label on the site, not just one from the page you name.
Omit the `#anchor` to print a whole page.
`search` matches plain substrings, case-insensitively, so short queries can match inside unrelated words.
Exit codes: 0 ok, 1 no results, 2 not a MyST site, 3 network error.
A `warning:` on stderr means part of a section didn't convert; the markdown on stdout is still usable.

## Learn the rest from the tool itself

This project's own docs are a MyST site.
Query them with the commands above instead of guessing:

```bash
docslice search https://responsible-genai-hackweek.github.io/MySTifAI "cache"
docslice get 'https://responsible-genai-hackweek.github.io/MySTifAI/develop#running-things'
```