Agent skill

Skill Optimization Guide

by openyida in openyida/openyida

当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件,按四步流程重写,产出结构清晰、入口薄、描述直白的 skill 文档集。

MITAuto-check passed

Install Skill Optimization Guide

skills CLI
$ npx skills add openyida/openyida --skill skill-optimization-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install openyida/openyida skill-optimization-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/skill-optimization-guide .claude/skills/skill-optimization-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-optimization-guide
GitHub stars
220
Token cost
~476 tokens
SKILL.md length
135 words
Files
9 (incl. references)
Skills in repo
58
Repo updated
First seen
Licence
MIT

At a glance

当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件,按四步流程重写,产出结构清晰、入口薄、描述直白的 skill 文档集。

  • Works in 3 steps: 严禁删除规则不告知:优化过程中发现原 skill… → 严禁编造规则:只重组和改写已有内容,不能自己发明新的业务规则塞进去。 → 严禁破坏 script/…
  • SKILL.md covers 作用域, 铁律, 流程概览 and 核心规则, plus 2 more sections
  • Runs Shell scripts from its folder

What it does

Skill Optimization Guide is an agent skill from openyida/openyida. 当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件,按四步流程重写,产出结构清晰、入口薄、描述直白的 skill 文档集。

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/anti-patterns.md`, `references/directory-convention.md` and `references/writing-rules.md`).

The repository describes itself as: Your own personal YiDA AI assistant! The licence is MIT.

Example prompts

  • “/skill-optimization-guide”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 严禁删除规则不告知:优化过程中发现原 skill 的规则,即使觉得不合理也必须保留或明确询问用户,不能默默删掉。
  2. 严禁编造规则:只重组和改写已有内容,不能自己发明新的业务规则塞进去。
  3. 严禁破坏 script/ 中可运行脚本:改写文档时不能修改脚本逻辑,只能更新脚本中的路径引用。

What it can do on your machine

Read from SKILL.md and the folder at commit 3dd4693. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Optimization Guide loads about 476 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 25 tokens; SKILL.md has 135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~476
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from openyida/openyida at commit 3dd4693, republished under its MIT licence (© openyida). 135 words, ~476 tokens.

Download SKILL.mdSave it as .claude/skills/skill-optimization-guide/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
skill-optimization-guide
description
当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件,按四步流程重写,产出结构清晰、入口薄、描述直白的 skill 文档集。

skill-optimization-guide

把一个臃肿或混乱的 skill 文档集,改写成入口薄、描述直白、无重复的标准结构。

作用域

用户诉求判定动作
"优化 XX skill" / "重写 XX 技能文档"本 skill进入下方流程
"新建一个 skill"不是本 skill交给 skill-create
"只改某条规则"不是本 skill直接编辑目标文件

铁律

  1. 严禁删除规则不告知:优化过程中发现原 skill 的规则,即使觉得不合理也必须保留或明确询问用户,不能默默删掉。
  2. 严禁编造规则:只重组和改写已有内容,不能自己发明新的业务规则塞进去。
  3. 严禁破坏 script/ 中可运行脚本:改写文档时不能修改脚本逻辑,只能更新脚本中的路径引用。

流程概览

📌 仅当判定为「优化已有 skill」时进入此流程。

步骤名称功能描述产出物
1评估现状逐文件阅读,统计行数、标记重复和抽象词、核对规则数问题清单
2拆分重组根据问题清单规划新文件结构,确定每条信息只放一处新文件清单
3逐文件改写按写作规则逐个文件改写,确保直白、正向、无重复改写后的全部文件
4验证收尾结构、重复、语言、一致性四维验证验证报告

核心规则

  1. 入口必须薄:SKILL.md 建议 300 行以内,只放作用域、铁律、流程、核心规则、参考文件这几类章节。
  2. 流程按复杂度选格式:简单流程直接在 SKILL.md 里写 Step 1/2/3;复杂流程(步骤多或单步内容长)才拆到 workflow/ 目录。
  3. 一条规则只写一处:入口写一句话摘要,详细解释只放在 references 的一个文件里。
  4. 用直白话写:每句话写成"对象 + 动作 + 产物",不用胶水、赋能、闭环、中台这类抽象词。
  5. 正向引导优先:先写"应该做什么",只在高风险场景(铁律)写"禁止做什么"。
  6. 规则数量必须对齐:入口说 N 条规则,references 里展开也必须是 N 条。
  7. 章节名称选最直白的:比如"铁律"比"严禁事项"更直白,"入口快速路由"在复杂路由场景比"作用域"更清晰。

Checklist

  • SKILL.md 建议 300 行以内
  • 任意两个文件内容重叠不超过 8%
  • 所有规则只在一处有详细解释
  • 无抽象词(胶水/赋能/闭环/中台/一体化)
  • 参考文件列表覆盖 references/ 下所有文件
  • 所有相对路径链接可达
  • script/ 下的脚本可直接运行(如果有)
  • 铁律覆盖了该 skill 的高风险操作

参考文件

文件说什么什么时候读
目录规范skill 目录怎么建、每层放什么、script 和 assets 的区别步骤 2 拆分重组时必读
写作规则用词、句式、铁律写法、代码去重标准步骤 3 逐文件改写时必读
反模式速查常见错误和对应的正确做法步骤 4 验证时对照检查

© openyida, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in .agents/skills/skill-optimization-guide of openyida/openyida.

  • SKILL.md
  • references/anti-patterns.md
  • references/directory-convention.md
  • references/writing-rules.md
  • script/check-skill.sh
  • workflow/step-1-assess.md
  • workflow/step-2-restructure.md
  • workflow/step-3-rewrite.md
  • workflow/step-4-verify.md

Open the folder on GitHubat commit 3dd4693

More from openyida/openyida

All 58 skills in this repo
  • Yida Canvas Custom Page

    openyida/openyida

    宜搭自定义页面开发规范,使用 YidaCodeCanvas 组件实现现代 React18 自定义页面。用于官网、看板、工作台、列表、详情、门户壳、可视化、hooks 交互、表单入口,以及需要门户组件、数据管理视图、成员、部门或上传组件的场景;发布层自动注入 yida/utils window 桥。

    220 GitHub stars~4.3k tokensUpdated 7 days ago
    Auto-check passed
  • Openyida Release

    openyida/openyida

    快速发布 OpenYida npm 正式版或测试版。用户说“发布正式版”“发布测试版”“发 beta”或要求按当天日期生成版本 tag 时使用;不用于宜搭应用或自定义页面发布。

    220 GitHub stars~520 tokensUpdated 7 days ago
    Auto-check passed
  • Yida Design Plan

    openyida/openyida

    Plan 模式的视觉设计分支。基于需求选择视觉方向,再结合业务页面规划维护 build-plan.json 的 visualStyle,供 CLI 派生 design.md。

    220 GitHub stars~756 tokensUpdated 7 days ago
    Auto-check passed
  • Prevent stale local OpenYida custom page source from overwriting live designer edits.

    220 GitHub stars~1.2k tokensUpdated 7 days ago
    Auto-check passed
  • Codemap

    openyida/openyida

    Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

    220 GitHub stars~1k tokensUpdated 7 days ago
    Auto-check passed
  • Sdd Riper One Light

    openyida/openyida

    面向 GPT-5.5 等强模型和熟练用户的轻量 AI Agent Harness / checkpoint-driven coding skill。默认用户已经把任务切到基本可执行的最小混沌单元;模型自行分解、探索与推进,人类通过最终目标、最小 spec、复述、checkpoint、证据验证与回写来低干扰控盘。

    220 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed

Questions about Skill Optimization Guide

What does Skill Optimization Guide do?

当需要优化一个已有 skill 文档时触发。读取目标 skill 全部文件,按四步流程重写,产出结构清晰、入口薄、描述直白的 skill 文档集。. Skill Optimization Guide is an agent skill from openyida/openyida.

How do I install Skill Optimization Guide in Claude Code?

Run `npx skills add openyida/openyida --skill skill-optimization-guide -a claude-code`. Or copy the skill folder (.agents/skills/skill-optimization-guide in openyida/openyida) into .claude/skills/skill-optimization-guide in your project. Claude Code loads it when a task matches its description.

How do I install Skill Optimization Guide in Codex?

Run `npx skills add openyida/openyida --skill skill-optimization-guide -a codex`. Or copy the skill folder (.agents/skills/skill-optimization-guide in openyida/openyida) into .agents/skills/skill-optimization-guide in your project. Codex loads it when a task matches its description.

Can I use Skill Optimization Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add openyida/openyida --skill skill-optimization-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-optimization-guide, .gemini/skills/skill-optimization-guide, .github/skills/skill-optimization-guide and .opencode/skills/skill-optimization-guide in your project.

What does Skill Optimization Guide need to run?

Going by SKILL.md and its folder, Skill Optimization Guide needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Skill Optimization Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Optimization Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Optimization Guide use?

Skill Optimization Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Optimization Guide use?

About 476 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

Who maintains Skill Optimization Guide?

openyida (a GitHub organization) maintains it in openyida/openyida, which has 220 GitHub stars. The repository holds 58 skills in this directory. The repository was last updated on September 30, 2026.

Source: openyida/openyida on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.