Skill Description Optimizer

Meta-skill for optimizing skill descriptions using SDS standard and seven core techniques. Use when refining skill descriptions for improved trigger rates (examples include optimizing existing descriptions, validating quality, or creating new skills), or any other skill description optimization tasks.

5 stars 2 forksSkill & Plugin Authoring

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add LZMW/skill-description-optimizer --skill skill-description-optimizer

Manual install

git clone --depth 1 https://github.com/LZMW/skill-description-optimizer.git /tmp/skill-description-optimizer
mkdir -p ~/.claude/skills
cp -r /tmp/skill-description-optimizer/. ~/.claude/skills/skill-description-optimizer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Skill Description 优化专家

你是 Skill Description 领域的终极优化官，精通 SDS 标准和编写最佳实践。你的职责是通过系统化分析现有 skill 模式，为用户的 skill description 提供高触发率的优化方案，同时确保与现有 skill 群体无冲突。

## 参考资料说明

在执行优化任务时，应参考 `references/best_practices.md` 获取：
- SDS 标准、万能公式、五大模板、七大技巧
- 触发短语库、质量检查清单、数据指标
- 完整示例和常见错误

**何时读取**：Phase 2（冲突检测）和 Phase 3（优化执行）开始前

---

# 1. Context (背景) [C]

Skill Description 是 Claude 判断是否使用 skill 的唯一依据，但许多 skill 的 description 编写质量不佳，导致触发率低下。本 Skill 设计用于两阶段优化流程：

**任务环境**：
- **第一阶段（搜索分析）**：搜索用户现有的所有 skills（`.claude/skills/` 目录），提取每个 skill 的 `name` 和 `description`，分析现有 descriptions 的触发词和模式
- **第二阶段（优化执行）**：基于最佳实践文档，对用户指定的 skill description 进行优化，确保优化后的 description 与现有 skill 群体适配，避免冲突，提高触发率

**前置条件**：
- 用户指定需要优化的 skill name 或 description
- 最佳实践文档路径：`references/best_practices.md`
- 可用的文件系统访问权限（Glob, Read, Grep, Bash）

**原始数据来源**：
- 用户现有的 skills 目录（通过 Glob 搜索）
- 最佳实践文档（通过 Read 读取）
- 用户提供的待优化 description

## 1.1 核心示例

**Input**: "帮我优化这个 skill description：'Tool for creating PDF documents.'"

**Output**:

**Phase 1: 搜索分析**
- 发现现有 skills：4个
- 触发词模式分析：现有 descriptions 平均包含 "skill" × 3次，触发场景数平均 3.5个
- 冲突检测：未发现与 "PDF" 或 "document" 相关的现有 skill

**Phase 2: 优化执行**
- 应用万能公式（参考 `references/best_practices.md`）
- 选择模板：模板 1（文件处理类）
- 优化后 description：

Read the full skill on GitHub

Details

Skill name: skill-description-optimizer
Repository: LZMW/skill-description-optimizer
License: MIT
Repo updated: 15 January 2026

FAQ

What does the Skill Description Optimizer skill do?

How do I install the Skill Description Optimizer skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add LZMW/skill-description-optimizer --skill skill-description-optimizer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Skill Description Optimizer popular?

It lives in LZMW/skill-description-optimizer, which has 5 GitHub stars and 2 forks.

Related skills

Eskill

hedralab/eskill

Skill mẹ tạo skill (meta-skill) — quy trình sản xuất Agent Skills chuẩn top-1: theo spec chính thức agentskills.io, Cursor Agent Skills (create-skill), quy trình eval của anthropics/skills (skill-creator), và kinh nghiệm thực chiến build egram/eseed. Dùng khi cần TẠO skill mới, CẢI THIỆN skill cũ, validate/kiểm tra skill, chuẩn bị skill bán thương mại, skill cho Cursor (~/.cursor/skills), hoặc khi user nói "tạo skill", "làm eskill", "viết SKILL.md", "skill ngon nhất", "skill Cursor".

Skill & Plugin AuthoringIn 1 list

Skill Audit Skills

LeeFeee/skill-audit-skills

对用户指定的 skill.md 文件及其配套的文档、程序、脚本等进行安全审查，识别恶意命令、文件操作、网络访问、依赖安装风险、技能描述与实际行为不符等风险行为。当用户需要审计技能安全性、检查技能是否有恶意代码、审查技能供应链风险时使用此技能。

Skill & Plugin Authoring

Skill Tuner

DENGYUFAN0/skill-forge

Skill 精修器（单链路）：借鉴 microsoft/SkillOpt 的思路（rollout→反思→增删改→验证门控→产出更优 SKILL.md），压缩成一次走完的轻量流程，用来优化某个已安装的 skill（如 elon-musk、qiushi 等）。 MANUAL-INVOKE ONLY — 平时绝不自动触发。即使用户在普通聊天里说「优化一下」「这个 skill 不太好」「帮我调调」，也【绝不】激活本 skill。仅当用户【显式】输入 `/skill-tuner`，或中文「启用调优模式」「进入调优模式」「skill 调优」「调优 skill」，或以「优化 skill」「调优：」开头，或明确说「优化 <某>skill / 调优 <某>skill」时，才进入本模式。进入后按七步流程走完一次；直到用户【显式】说「退出调优」「退出」「结束调优」「切回正常」才结束。

Skill & Plugin AuthoringIn 1 list

Skill Design Guide

metaskills/skill-design-guide

Comprehensive guide for designing, building, testing, and distributing Claude skills. Use when user wants to "create a skill", "build a skill", "write a SKILL.md", "design a workflow skill", "make an MCP skill", or asks about skill structure, frontmatter, trigger phrases, or skill best practices. Walks through the full lifecycle from use case definition to distribution.

Skill & Plugin Authoring

Plugin Creator

jeremylongshore/claude-code-plugins-plus-skills

Automatically creates new Claude Code plugins with proper structure, validation, and marketplace integration when user mentions creating a plugin, new plugin, or plugin from template. Specific to claude-code-plugins repository workflow. allowed-tools: Write, Read, Grep, Bash

Skill & Plugin Authoring

Skill Creator

grub-404/claude-skill-skill

Create new Claude Code skills with proper structure and conventions. Use when the user wants to create a new skill, scaffold skill templates, or understand skill anatomy.

Skill & Plugin Authoring

Browse the most popular Claude skills, all skill & plugin authoring skills, or write your own with the skills generator.