optimize-skill-description

Optimize skill descriptions with YAML frontmatter and trigger-rate evaluations.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/notwillk/skills --skill optimize-skill-description
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-skill-description
Source: https://github.com/notwillk/skills/tree/main/skills/optimize-skill-description
Command: npx skills add https://github.com/notwillk/skills --skill optimize-skill-description

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml>=6.0, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Optimize skill descriptions to improve activation reliability, prevent misfires, and streamline evaluation workflows for AI agents.

Core Features & Use Cases

  • Progressive disclosure design and evaluation workflow: design eval queries, split train/validation, run multi-run trigger-rate evaluations, and derive actionable improvements.
  • Best-practice guidance: maintain a 60/40 train/validation split, avoid overfitting, and use near-miss negative examples to sharpen boundaries.
  • Automated analysis and reporting: generate markdown reports, summary stats, and recommendations to drive iteration.

Quick Start

Create or update the SKILL.md with a clear description, then use the included scripts to generate eval queries and run trigger-rate evaluations.

Frequently Asked Questions about optimize-skill-description

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize AI agent skill descriptions to prevent trigger misfires?

To optimize skill descriptions and prevent trigger misfires, design evaluation queries, split train/validation data, run multi-run trigger-rate evaluations, and generate analysis reports to drive iterative improvements.

What is the best way to evaluate AI agent trigger reliability?

Evaluating trigger reliability involves maintaining a 60/40 train/validation split, running progressive disclosure evaluations, and using near-miss negative examples to sharpen activation boundaries.

How do I design evaluation queries for AI skills?

Designing evaluation queries requires creating targeted prompts that test skill activation, splitting them into train and validation sets, and measuring trigger rates across multiple runs to identify misfires.

Why does my AI agent trigger the wrong skill?

Wrong skill triggers occur when descriptions lack boundary clarity. Using near-miss negative examples during evaluation sharpens activation rules and reduces misfires across similar skills.

Do I need YAML frontmatter to optimize skill descriptions?

Yes, YAML frontmatter with name, description, license, and metadata at the root is required to optimize skill descriptions and run trigger-rate evaluation workflows.