reference-ingest SKILL.md skillA
reference-ingest from pillumina/ascend-sleuth is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add pillumina/ascend-sleuth/reference-ingest@git:20261009.3640a77Pins git:20261009.3640a77 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- pillumina/ascend-sleuth
- Path
skills/reference-ingest/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261009.3640a77, committed Oct 9, 2026
- First version recorded
- Sep 15, 2026
- Size
- 11,145 bytes
- Repository stars
- 5
- License
- MIT
从 GitCode 等可按 API 枚举的**文档仓**批量摄取官方文档，沉淀为 reference 先验词条（面向训练/推理的中断、精度、性能定位）。编排「仓库文档面普查 → 增量扫描（path×blob sha 记账，防重复抓取与重复评估）→ 候选筛选 → 按需抓正文到本地缓存（ref-docs/，git-ignored，sha 校验）→ 抽取 → 走 to-reference 归类产出 → mark 回写判定」；状态文件 reference-ingest-state.json 是唯一台账，`skipped` 也记账（判过不沉淀的文档下一轮不再评估）。以 token 节省为设计约束：脚本只拉目录树、正文按候选抓、码块与日志裁剪后再读。这是「文档语料 → reference」的统一批量注入入口，与 issue-ingest（issue → case）、to-reference（零散来源 → reference）互补。.
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
# Reference Ingest 把**上游文档仓**里的官方文档批量吸收成先验知识。适合：组织（如 GitCode 的 `cann`）下有几十个仓，每个仓的 `docs/` 里散着真正专业的定位手册、错误码表、FAQ、调优指南，而人工一篇篇读不现实、读完也记不住读过哪些。 ## 与相邻 skill 的分工（先分清再动手） | 入口 | 输入 | 产出 | 幂等状态 | |---|---|---|---| | `issue-ingest` | 上游 issue 线程 | case 草稿 → inbox | `ingest-state.json`（按 issue 号） | | `to-reference` | 零散来源（内联 / 单文件 / URL / case 归纳） | reference 词条（active） | 无（单次产出） | | **本 skill** | **成规模的文档仓** | reference 词条（active，走 to-reference 的产出规则） | `reference-ingest-state.json`（按 path × blob sha） | **产出规则不在本 skill 里**：怎么归类（type 选择）、怎么写（schema 完整性、零注释、symptom 可 grep）、grill 强度、深审门槛——全部以 `skills/to-reference/SKILL.md` 为准，本 skill 只负责**把候选正文以最低成本、可追溯、不重复的方式交到那一步**。 ## 前置 无外部 CLI 依赖：`scripts/gc_docs.py` 直连 GitCode API（读公开仓不需要 token）。任务开始前先确认它可用（`python3 scripts/gc_docs.py repos --org cann | head -3`）；报错就先修脚本而不是改走手工路径。 ## 输入方式 ``` /skill:reference-ingest cann/hccl # 指定仓：扫全仓文档面并给候选 /skill:reference-ingest --org cann --status # 看台账：各源决策分布（哪些仓扫过、多少未评） /skill:reference-ingest cann/hccl --prefix docs/zh/user_guide/fault_diagnosis # 指定子面（推荐：先吃结构化手册） /skill:reference-ingest "继续沉淀" # 续接：读台账找 pending 与未扫的源，按优先级推进 ``` | 用户给到什么 | agent 行为 | …
Read the whole file at its exact version.
How to install
mdr add pillumina/ascend-sleuth/reference-ingest@sha256:b1f8e6ff32c1ab26The line at the top of this page pins the label git:20261009.3640a77, 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_3lcdgb4weoxkas57)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 15, 2026 and Oct 9, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261009.3640a77 latest | 2026-10-09 | 3640a77 | 11,145 B | A | view · diff |
| git:20260917.709504c | 2026-09-17 | 709504c | 11,142 B | A | view · diff |
| git:20260915.b0521f3 | 2026-09-15 | b0521f3 | 11,136 B | A | view · diff |
| git:20260915.3d99afb | 2026-09-15 | 3d99afb | 10,664 B | A | view · diff |
| git:20260915.7165d97 | 2026-09-15 | 7165d97 | 9,479 B | A | view |
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 (11145 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
pillumina/ascend-sleuth · 5 stars · license MIT · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_3lcdgb4weoxkas57 GET https://markdownregistry.com/api/v1/resolve?ref=pillumina/ascend-sleuth/reference-ingest GET https://markdownregistry.com/api/v1/blob/b1f8e6ff32c1ab26ed4fe5318753418f2a2a0cc54dc80d2c53f940cec479a721
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.