Find the installed folder; edit SKILL.md.

Open the skill directory on disk and edit SKILL.md. That is the file hosts load. Keep the folder name and the frontmatter name aligned when the host requires a match (Cursor and VS Code both say the name must match the parent folder).

Third-person description: what it does and when to use it.

Required fields on the open standard are name and description. The description is how the agent discovers the skill. Third person, concrete triggers, no first-person helper voice.

Keep the body a procedure.

Write steps the agent can follow. Move long notes into a sibling reference file one level deep and link it from the body so progressive loading still works.

Re-invoke /skill-name or a matching prompt.

In Claude, type /skill-name. In Cursor, / and the skill name. In Codex, /skills or $ to mention it. Or ask in plain language using the same trigger words as the description.

Do not edit Analog or shop .agents/skills.

Leave Analog and this shop’s internal .agents/skills alone. Those are not the public pack. See How not to use portable skills.