material-retrieve SKILL.md skillA
material-retrieve 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-retrieve@v1.1.0Pins v1.1.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-retrieve/SKILL.md- Versions recorded
- 1
- Latest version
- v1.1.0, committed Sep 8, 2026
- Size
- 3,113 bytes
- Repository stars
- 9
- License
- none declared
从素材库中按主题、标签、类型检索可复用的写作素材。当用户说"找素材""查素材""关于XX的素材""检索素材库""有没有关于XX的东西""翻翻素材库"时使用此技能。当用户在写作过程中需要支撑材料时也应主动建议使用。.
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/`：
- `index.jsonl` — 素材索引（JSONL 格式，每行一条 {id, summary, tags, type, source_title, reusability}）
- `entries/{id}.json` — 素材完整内容
## 执行流程
### 1. 读取索引
读取 `./writing-workspace/materials/index.jsonl`。
- 如果文件不存在或为空：告诉用户"素材库还是空的，可以用 material-ingest 技能先入库一些文章。"然后结束。
- 如果有内容：继续检索。
### 2. 解析用户查询
从用户输入中提取检索条件，支持以下维度的任意组合：
| 维度 | 示例 |
|------|------|
| 关键词 | "关于创业的素材" → 关键词"创业" |
| 标签 | "标签是AI的" → 标签匹配"AI" |
| 类型 | "找一些案例" → type=case |
| 情绪 | "有没有比较犀利的观点" → sentiment=provocative |
| 复用度 | "找那些可以直接用的" → reusability=high |
如果用户只给了一个主题词，同时按关键词和标签两个维度匹配。
### 3. 多维匹配
遍历 index.jsonl 中的所有条目，按以下逻辑匹配：
**关键词匹配**（模糊）：
- 检查 summary 和 tags 中是否包含查询词或其近义词
- "创业"应匹配"初创公司""创业者""startup"
- "AI"应匹配"人工智能""大模型""LLM"
**标签匹配**（精确 + 模糊）：
- 精确匹配优先
- 同义标签也算匹配（如上）
**类型/情绪/复用度匹配**（精确）：
- 直接对比字段值
### 4. 排序
匹配结果按以下优先级排序：
1. 相关度（匹配维度越多越靠前）
2. 可复用程度（high > medium > low）
3. 时间（新的优先）
### 5. 读取完整内容
对排序后的前 10 条结果，读取 `entries/{id}.json` 获取完整 content。
### 6. 展示结果
```
## 素材检索结果
查询：关于"创业"的素材
匹配：共 X 条
| # | ID | 类型 | 摘要 | 标签 | 复用度 |
|---|-----|------|------|------|--------|
| 1 | mat_xxx | viewpoint | ... | 创业, AI | high |
…Read the whole file at its exact version.
How to install
mdr add simonwong/skills/material-retrieve@sha256:0033163f3417a412The line at the top of this page pins the label v1.1.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_565zrsymiw7xjcj6)
2 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 (3113 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_565zrsymiw7xjcj6 GET https://markdownregistry.com/api/v1/resolve?ref=simonwong/skills/material-retrieve GET https://markdownregistry.com/api/v1/blob/0033163f3417a4121cd8874c0d4a04146d3fa5e712b71112aafd1251440a0634
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.