tool-description-optimizer

Installation
SKILL.md

Tool Description Optimizer

What it does

A skill's description is its only discovery mechanism. If the description is vague, overlapping, or keyword-poor, the agent won't trigger it — or worse, will trigger the wrong skill. Tool Description Optimizer analyzes every installed skill's description for trigger quality and suggests concrete rewrites.

Inspired by OpenLobster's tool-description scoring layer, which penalizes vague descriptions and rewards keyword-rich, action-specific ones.

When to invoke

  • After installing new skills — check if descriptions are trigger-ready
  • When a skill isn't firing when expected — diagnose whether the description is the problem
  • Periodically to audit all descriptions for quality drift
  • Before publishing a skill — polish the description for discoverability

How it works

Scoring dimensions (5 metrics, 0–10 each)

Related skills
Installs
17
GitHub Stars
61
First Seen
Mar 21, 2026