How Well-Written OpenClaw Skill Frontmatter Determines Agent Usefulness

OpenClaw skills are structured directories containing a SKILL.md file with YAML frontmatter and a markdown body, where the frontmatter acts as a lightweight filter agents scan before loading full instructions. The quality of a skill's frontmatter — particularly its description field — determines whether an agent correctly matches it to user requests or ignores it entirely. Effective descriptions go beyond vague taglines by specifying action verbs, relevant objects, and literal command strings that an agent's matcher can anchor to precisely. Poorly disambiguated trigger conditions across similar skills can cause agents to guess incorrectly or load multiple redundant skills, wasting context. The guide uses real published pilot-* skills as worked examples to illustrate how precise frontmatter design separates instantly useful skills from those that sit ignored despite being technically relevant.