Skip to main content

Skill Optimizer

Skill Active

Use when the user wants to analyze, audit, or improve their Agent Skills (SKILL.md files). Triggers on /optimize-skill, /skill-audit, 'optimize skills', 'analyze skills', 'check my skills', 'skill quality'. Also use proactively when the user mentions skills aren't triggering, skills feel broken, or asks why a skill didn't fire.

Purpose

To help users analyze, audit, and improve their Agent Skills for better performance and discoverability by identifying issues across multiple dimensions.

Features

  • Analyzes Agent Skills using static checks and historical session data
  • Scores skills on a 5-point composite scale across 8 dimensions
  • Provides P0/P1/P2 prioritized fixes in a diagnostic report
  • Detects undertriggering and suggests description improvements
  • Supports Claude Code, Codex, and other Agent Skills compliant platforms

Use Cases

  • When users want to analyze or audit their Agent Skills (SKILL.md files)
  • When skills aren't triggering as expected or feel broken
  • When users ask about skill quality or performance
  • Proactively, to optimize skill descriptions and performance

Non-Goals

  • Modifying skill files directly
  • Prescribing specific wording without evidence-based suggestions
  • Providing generic feedback without quantifying findings

Workflow

  1. Identify target skills
  2. Collect session data
  3. Run 8 analysis dimensions
  4. Compute composite scores
  5. Output report with P0/P1/P2 fixes

Practices

  • Skill Auditing
  • Documentation Improvement
  • Performance Analysis

Prerequisites

  • Claude Code, Codex, or other Agent Skills compliant platform
  • Access to session transcripts (JSONL files)

Versioning

  • warning:Release ManagementThe installation instructions reference 'main' and there is no manifest version, changelog, or release tags, making version pinning impossible.

Install

  • warning:Installation instructionThe README provides installation instructions for various agents, but does not include a copy-pasteable invocation example.

Practical Utility

  • warning:Usage examplesWhile the README shows installation and usage commands, it lacks end-to-end examples demonstrating input, invocation, and observable output for the skill's core analysis functionality.

Installation

/plugin install skill-optimizer@hqhq1025-skill-optimizer

Quality Score

75 /100
Analyzed about 14 hours ago

Trust Signals

Last commitabout 1 month ago
Stars75
LicenseMIT
Status
View Source

© 2025 SkillRepo · Find the right skill, skip the noise.