outline-read SKILL.md skillA
outline-read from functoreality/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add functoreality/agent-skills/outline-read@git:20261026.728ea8cPins git:20261026.728ea8c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- functoreality/agent-skills
- Path
skills/outline-read/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261026.728ea8c, committed Oct 26, 2026
- Size
- 4,285 bytes
- Repository stars
- 11
- License
- LGPL-3.0
浏览采用 Tab 缩进、层级很深的大纲式 Markdown,通过目录和折叠展开定位局部内容。 也可在大纲或平铺 Markdown 中,按 ((uid)) 引用定位行末的 {uid} 定义, 返回位置或上下文。UID 无须采用特定生成算法。文件短小或层级较浅时直接阅读。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# outline-read 提供两项可独立使用的能力,以及一步完成定位与展开的入口: - `outline-read`:按文件、行号展示 Tab 大纲的结构上下文,也可按 UID 定位后展开。 - `uid-locate`:按 UID 定位,不依赖缩进或大纲结构,可返回位置、连续上下文或 JSON。 需要 Python 3.10+,仅使用标准库。脚本在本 skill 的 `scripts/` 中, 以下路径均相对于本 skill 目录,实际执行时替换为安装位置。 安装不会自动把这些脚本加入 `PATH`。 ## 选择入口 | 目的 | 调用 | |------|------| | 看大纲的顶层目录 | `scripts/outline-read --dir /path/to/notes report` | | 看第 120 行的结构上下文 | `scripts/outline-read --dir /path/to/notes report 120` | | UID 定位后直接展开大纲 | `scripts/outline-read --dir /path/to/notes --uid topic-123` | | 只获取 UID 的位置 | `scripts/uid-locate --dir /path/to/notes topic-123` | | 看 UID 前后各 4 行原文 | `scripts/uid-locate --dir /path/to/notes topic-123 --context 4` | 支持省略文件的 `.md` 后缀,以及 `report.md:120` 简写。 文件路径和行号可以直接来自 `rg -n` 的搜索结果,不需要先创建 UID。 连续原文阅读和关键词搜索仍可使用环境提供的文件读取工具与 `rg`。 `read` 若是环境的工具名,不应当作 Bash 的文件读取命令运行。 ## 大纲展开 大纲层级由行首 Tab 数量确定。此工具不解析普通 Markdown 的标题层级、 空格缩进或代码块语义。应确认文件采用这种大纲格式后再使用折叠功能。 所有展开模式都会保留祖先链和目标行,目标子节点由 `--depth` 独立控制: | `--expand` | 在祖先链和目标之外展示什么 | |------------|--------------------------| | `0` 或 `--tight` | 不额外展示兄弟节点 | | `1` | 非顶层目标的同级兄弟 | | `2` | 级别 1,加全部非空顶层行 | | `3`,默认 | 祖先链各层的兄弟节点,加全部非空顶层行 | ```bash …
Read the whole file at its exact version.
How to install
mdr add functoreality/agent-skills/outline-read@sha256:0125c5fc38b33500The line at the top of this page pins the label git:20261026.728ea8c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_yw47g7gvaqgclzhu)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 26, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4285 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
functoreality/agent-skills · 11 stars · license LGPL-3.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yw47g7gvaqgclzhu GET https://markdownregistry.com/api/v1/resolve?ref=functoreality/agent-skills/outline-read GET https://markdownregistry.com/api/v1/blob/0125c5fc38b335004e31cdff5babcfcec14c8eddbc25f1968dc143b7e560dcec
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.