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.

Install it, pinned
mdr add functoreality/agent-skills/outline-read@git:20261026.728ea8c

Pins 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

The exact contents, by fingerprint
mdr add functoreality/agent-skills/outline-read@sha256:0125c5fc38b33500

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

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_yw47g7gvaqgclzhu.svg)](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.

versioncommittedcommitsizeaudit
git:20261026.728ea8c latest2026-10-26 728ea8c 4,285 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • 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

GitHub

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.

More from functoreality/agent-skills

causal-chain-analysis SKILL.md skill
functoreality/agent-skills · skills/causal-chain-analysis/SKILL.md · 因果链分析是现代TRIZ理论中深入分析问题的重要工具。当用户提到"因果链分析",或对某种情形不满、又想不出好办法时,使用此skill。该skill能够帮助用户从表层问题出发,通过反复追问"为什么",层层深入挖掘问题的根本原因,建立完整的因果…
v260822 · audit A · 11 stars
purpose-means-analysis SKILL.md skill
functoreality/agent-skills · skills/purpose-means-analysis/SKILL.md · 当用户希望实现一项尚未实现的正向功能或构造新系统, 并想从该根本目的出发逐层分析可用手段时使用。 也用于为替换已有系统而重新分析其原本功能, 还原论文、算法和已有方案如何逐层实现预期功能;…
v261105 · audit A · 11 stars
skill-refiner SKILL.md skill
functoreality/agent-skills · skills/skill-refiner/SKILL.md · 通过复盘反思或专家输出对比,发现并提炼思维/写作/设计型 skill 的改进方向。 适用于分析问题、写高质量笔记等产出质量无客观指标,需要靠推演和专家判断来评估的 skill。 当用户要求审查、改进、更新或复盘某个…
v260804 · audit A · 11 stars
task-final-review SKILL.md skill
functoreality/agent-skills · skills/task-final-review/SKILL.md · 在任务收尾或关键阶段进入后续工作前,分别判断需求覆盖、结果验证及独立评审的必要性, 尤其关注后续依赖当前结果、前序改动可能造成较大返工的情形。 按需组合自查、脚本校验、运行测试、事实核查、试用或子 agent 评审。…
git:20261105.4255c36 · audit A · 11 stars

Every file in functoreality/agent-skills

Browse by kind, by grade A, or by owner.