skill-optimizer

Analyze agent skill files and generate diagnostic reports on trigger accuracy.

Updated May 5, 2026
One-click install
npx skills add https://github.com/iani-kuli/harness_bro --skill skill-optimizer-iani-kuli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-optimizer
Source: https://github.com/iani-kuli/harness_bro/tree/main/.claude/skills/curated/meta/skill-optimizer
Command: npx skills add https://github.com/iani-kuli/harness_bro --skill skill-optimizer-iani-kuli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the common issue of agent skills failing to trigger or underperforming due to poorly written descriptions and lack of clear workflow markers.

Core Features & Use Cases

  • Diagnostic Reporting: Analyzes skills across 8 dimensions including trigger rates, user reaction, and workflow completion.
  • CSO (Claude/Agent Search Optimization): Provides evidence-based suggestions to improve skill selection rates by agents.
  • Use Case: If you notice your custom agent skills are rarely being invoked despite relevant user requests, use this tool to identify if your skill descriptions are missing critical trigger keywords or failing to follow progressive disclosure best practices.

Quick Start

Run the skill-optimizer to scan all installed skills and generate a prioritized diagnostic report.

Frequently Asked Questions about skill-optimizer

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

FAQPage Schema
Why are my custom agent skills rarely triggered despite relevant user requests?

Agent skills undertrigger when their descriptions lack critical trigger keywords and clear workflow markers. A diagnostic audit evaluates skill descriptions against search optimization metrics and session data to identify these exact quality gaps.

How do I audit agent skills for better trigger accuracy and workflow efficiency?

Auditing agent skills involves analyzing skill files and session transcripts to evaluate descriptions across 8 dimensions including trigger rates and workflow completion. This multi-dimensional diagnostic reporting identifies undertriggering issues and execution bottlenecks.

What is agent search optimization and how does it improve skill selection rates?

Agent search optimization, or CSO, improves skill selection rates by providing evidence-based suggestions to enhance skill descriptions. It analyzes session data to ensure descriptions follow progressive disclosure best practices and include necessary trigger keywords.

Do I need session transcripts to perform a skill performance diagnostic?

Yes, accessing session transcripts is required to perform a multi-dimensional diagnostic report. The audit needs both session transcripts and skill directory paths to evaluate user reaction, trigger rates, and workflow completion accurately.

Can I scan all installed skills at once to generate a prioritized diagnostic report?

Yes, you can run the optimizer to scan all installed skills within the specified directory paths. It generates a prioritized diagnostic report highlighting which skills require immediate description improvements for peak performance.

What are the limitations of using description audits for agent workflow optimization?

Description audits focus solely on improving trigger accuracy and search optimization metrics within skill files. They do not resolve underlying execution logic errors or external dependency failures that may also cause workflow completion issues.