I published a SKILL.md and nobody installed it. Here’s how to write one people actually keep

说明与用途

作者发布的 SKILL.md 未被安装，因为它是描述性的而非指令性的。他制定了五步方法（标题、触发器、步骤、反例、边界）来编写真正改变代理行为的技能。

问题

A developer published a Skill file (SKILL.md) that was never installed or used by agents, revealing that the skill was descriptive rather than instructive.

结果

By applying the five‑part method, the author can create SKILL.md files that are actually installed and used, rather than decorative.

工作流

• 1. Write a concise, claim‑based title that states what the skill does. 2. Craft a trigger description that specifies when the agent should load the skill. 3. Ensure every body line removes a choice the agent would otherwise make. 4. Include counter‑examples and boundaries to clarify limits. 5. Test the skill by checking that it changes agent behavior in the intended scenario.

证据

"Nice write-up. But my agent didn’t do anything differently than it would have anyway."

来源

A skill earns its place by removing a choice the model would otherwise make badly. If it doesn’t remove a choice, it’s a preamble.

来源

The agent reads the description first, and only if the description fires does it pull in the body.

来源