Engineer Skill

Use this skill to systematically improve agent skills by treating frontmatter optimization and prompt content optimization as two separate, composable concerns.

Read references/skill-structure-spec.md for the complete directory layout and file conventions before starting.

When to use this skill

• The user wants to create a new agent skill from scratch.
• The user wants to improve an existing skill's triggering accuracy (frontmatter).
• The user wants to improve an existing skill's execution reliability (body content).
• The user has a bloated SKILL.md and wants to restructure it with progressive disclosure.
• The user wants to extract deterministic instructions from prose into executable scripts.
• The user wants to validate a skill against the agentskills.io specification.
• The user asks about skill best practices, structure, or conventions.

Do not use this skill for general prompt engineering that is not tied to agent skill files. Use this skill only when the target artifact is a skill directory with a SKILL.md file or the user is creating one.

Required inputs