material-ingest SKILL.md skillA
material-ingest from simonwong/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add simonwong/skills/material-ingest@v1.2.0Pins v1.2.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- simonwong/skills
- Path
in-progress/material-ingest/SKILL.md- Versions recorded
- 1
- Latest version
- v1.2.0, committed Sep 8, 2026
- Size
- 7,774 bytes
- Repository stars
- 9
- License
- none declared
拆解文章，提取可复用的素材（观点、数据、案例、金句、类比、方法论），分类标注后存入素材库。当用户说"拆解素材""入库""收集这篇文章""提取素材""分析这篇文章的要点"或投喂文章希望留存有价值内容时使用此技能。即使用户只是分享文章并表达"这篇不错"，也应考虑是否需要入库。.
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
# 素材拆解入库
从文章中提取可独立复用的素材，分类标注后存入素材库。
## 核心理念
好的写作需要素材积累。这个技能把"读到一篇好文章"变成"素材库里多了几条可以用的东西"。
拆解的关键原则：**以"能独立引用"为粒度标准**。一条素材脱离原文上下文后，读者依然能理解它在说什么。如果一段话必须配合前后文才看得懂，那它不适合作为独立素材。
## 数据目录
所有素材存放在 `./writing-workspace/materials/`：
```
writing-workspace/materials/
├── index.jsonl # 素材索引（JSONL 格式，每行一条 {id, summary, tags, type, source_title}）
└── entries/ # 每条素材一个 JSON 文件
└── mat_xxx.json
```
首次使用时自动创建目录结构。
## 模式判断
根据用户措辞判断来源类型：
- 用户说"这是我写的""拆一下我的文章""分析下我这篇" → **自写模式**（`is_self: true`）
- 其他情况 → **外部来源模式**（`is_self: false`）
两种模式的基本拆解逻辑相同，自写模式有额外步骤。
---
## 拆解逻辑
### 第一步：通读理解
先通读全文，理解：
- 文章的核心主题是什么
- 作者的论证结构（先说什么后说什么，为什么这么安排）
- 哪些是作者的原创观点，哪些是引用的
### 第二步：按语义单元拆解
不按段落机械切割，而是按"观点/论据"语义单元拆解：
| 遇到这种内容 | 拆解为 |
|-------------|--------|
| 一个完整的观点或论断 | 一条 `viewpoint` 素材 |
| 支撑观点的数据/统计 | 一条 `data` 素材 |
| 具体案例或故事 | 一条 `case` 素材 |
| 值得直接引用的精彩句子 | 一条 `quote` 素材 |
| 生动的类比或比喻 | 一条 `analogy` 素材 |
| 可操作的方法论或框架 | 一条 `method` 素材 |
一篇文章通常拆出 3-10 条素材。太少说明文章信息密度低或拆解不够细，太多说明粒度太细了。
### 第三步：标注元信息
为每条素材标注：
- **tags**：2-5 个标签。标注前先读取现有 `index.jsonl`，参考已有标签避免同义重复（比如已有"创业"就不要再用"初创"）。如果素材库为空，自由标注。
- **sentiment**：`positive`（正面肯定）/ `negative`（批判否定）/ `neutral`（中性陈述）/ `provocative`（挑衅引发思考）
…Read the whole file at its exact version.
How to install
mdr add simonwong/skills/material-ingest@sha256:afa6bc692870e2b9The line at the top of this page pins the label v1.2.0, 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_rlrm2rtb2xcbbzza)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 8, 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 (7774 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
simonwong/skills · 9 stars · license none declared · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_rlrm2rtb2xcbbzza GET https://markdownregistry.com/api/v1/resolve?ref=simonwong/skills/material-ingest GET https://markdownregistry.com/api/v1/blob/afa6bc692870e2b9421be359159caf733ff5cc21a87f8ddd7a2089c9a3cda668
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.