Question 1

Why is my AI agent ignoring my installed skill, and how does this tool fix it?

Accepted Answer

This skill audits and rewrites your SKILL.md frontmatter to ensure your custom tools trigger reliably. It fixes common issues like vague descriptions, overlapping trigger phrases, and excessive token usage that prevent AI agents from recognizing when to use your skill.

Question 2

Which AI agents and CLI environments are compatible with these optimizations?

Accepted Answer

It is optimized for all SKILL.md-compatible environments, including Claude Code, Codex CLI, and Cursor. The optimizer ensures your metadata follows the specific conventions required by these harnesses for deterministic auto-invocation.

Question 3

How does the skill-description-optimizer help manage my agent's token budget?

Accepted Answer

The skill provides a 'preflight heuristic score' that evaluates your description against typical LLM context windows. It helps you trim 'token-hungry' descriptions so your skill remains active even in long, complex chat sessions.

Question 4

Can this skill help if I have multiple skills with overlapping functionality?

Accepted Answer

Yes, it specifically analyzes your 'should-trigger' and 'should-not-trigger' prompts to resolve conflicts. It detects if your skill's scope is too broad or if it competes with other installed skills, providing a rewritten version that carves out a clear, unique activation niche.

Question 5

What is included in the purchase of this skill?

Accepted Answer

You receive the full skill-description-optimizer package ready for installation in your preferred harness. This includes the logic for metadata auditing, description rewriting, and the scoring system for trigger reliability.

Skill Description Optimizer