skill-optimization-guide SKILL.md skillA
skill-optimization-guide from openyida/openyida is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add openyida/openyida/skill-optimization-guide@git:20260805.afde623Pins git:20260805.afde623 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- openyida/openyida
- Path
.agents/skills/skill-optimization-guide/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260805.afde623, committed Aug 5, 2026
- First version recorded
- Jul 28, 2026
- Size
- 3,650 bytes
- Repository stars
- 230
- License
- MIT
当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件，按四步流程重写，产出结构清晰、入口薄、描述直白的 skill 文档集。.
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
# skill-optimization-guide 把一个臃肿或混乱的 skill 文档集，改写成入口薄、描述直白、无重复的标准结构。 ## 作用域 | 用户诉求 | 判定 | 动作 | |---------|------|------| | "优化 XX skill" / "重写 XX 技能文档" | 本 skill | 进入下方流程 | | "新建一个 skill" | 不是本 skill | 交给 skill-create | | "只改某条规则" | 不是本 skill | 直接编辑目标文件 | ## 铁律 1. **严禁删除规则不告知**：优化过程中发现原 skill 的规则，即使觉得不合理也必须保留或明确询问用户，不能默默删掉。 2. **严禁编造规则**：只重组和改写已有内容，不能自己发明新的业务规则塞进去。 3. **严禁破坏 script/ 中可运行脚本**：改写文档时不能修改脚本逻辑，只能更新脚本中的路径引用。 ## 流程概览 > 📌 仅当判定为「优化已有 skill」时进入此流程。 | 步骤 | 名称 | 功能描述 | 产出物 | |------|------|----------|--------| | 1 | [评估现状](workflow/step-1-assess.md) | 逐文件阅读，统计行数、标记重复和抽象词、核对规则数 | 问题清单 | | 2 | [拆分重组](workflow/step-2-restructure.md) | 根据问题清单规划新文件结构，确定每条信息只放一处 | 新文件清单 | | 3 | [逐文件改写](workflow/step-3-rewrite.md) | 按写作规则逐个文件改写，确保直白、正向、无重复 | 改写后的全部文件 | | 4 | [验证收尾](workflow/step-4-verify.md) | 结构、重复、语言、一致性四维验证 | 验证报告 | ## 核心规则 1. **入口必须薄**：SKILL.md 建议 300 行以内，只放作用域、铁律、流程、核心规则、参考文件这几类章节。 2. **流程按复杂度选格式**：简单流程直接在 SKILL.md 里写 Step 1/2/3；复杂流程（步骤多或单步内容长）才拆到 workflow/ 目录。 3. **一条规则只写一处**：入口写一句话摘要，详细解释只放在 references 的一个文件里。 4. **用直白话写**：每句话写成"对象 + 动作 + 产物"，不用胶水、赋能、闭环、中台这类抽象词。 5. **正向引导优先**：先写"应该做什么"，只在高风险场景（铁律）写"禁止做什么"。 6. **规则数量必须对齐**：入口说 N 条规则，references 里展开也必须是 N 条。 …
Read the whole file at its exact version.
How to install
mdr add openyida/openyida/skill-optimization-guide@sha256:68113a03e23aaffaThe line at the top of this page pins the label git:20260805.afde623, 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_nuhyv7ss4ylhw42c)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Jul 28, 2026 and Aug 5, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260805.afde623 latest | 2026-08-05 | afde623 | 3,650 B | A | view · diff |
| git:20260804.3f96b25 | 2026-08-04 | 3f96b25 | 11,157 B | A | view · diff |
| git:20260804.464875d | 2026-08-04 | 464875d | 10,706 B | A | view · diff |
| git:20260728.2c22517 | 2026-07-28 | 2c22517 | 4,594 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 (3650 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
openyida/openyida · 230 stars · license MIT · pushed 2026-11-02 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_nuhyv7ss4ylhw42c GET https://markdownregistry.com/api/v1/resolve?ref=openyida/openyida/skill-optimization-guide GET https://markdownregistry.com/api/v1/blob/68113a03e23aaffa154a1b9e76e56bdc42eda6b283b1c2a23db307967ef60dd6
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.