skill-optimizer

Audit Claude Code skills and define testable incremental improvements with eval criteria.

2|Updated Sep 13, 2025
One-click install
npx skills add https://github.com/s977043/plangate --skill skill-optimizer-s977043
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-optimizer
Source: https://github.com/s977043/plangate/tree/main/.claude/skills/skill-optimizer
Command: npx skills add https://github.com/s977043/plangate --skill skill-optimizer-s977043

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured approach to evaluating and improving an existing Claude Code skill through small, testable changes guided by explicit success criteria, reducing risk and ensuring measurable quality improvements.

Core Features & Use Cases

  • Baseline audit: inspect the current skill package, invocation settings, and examples to identify concrete improvement opportunities.
  • Define success criteria: establish 3–6 measurable eval criteria covering trigger quality, task fidelity, safety, and output conformance.
  • Incremental optimization: propose single, small changes per proposal and link each to an eval hypothesis.
  • Risk management: include rollback rules and a clear evaluation plan to prevent regressions.
  • Use case: a team wants to tighten a skill's prompts to reduce over-triggering while preserving functionality.

Quick Start

Provide a small, a testable optimization proposal for an existing Claude Code skill and attach it to an eval plan.

Frequently Asked Questions about skill-optimizer

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

FAQPage Schema
How do I optimize a Claude Code skill incrementally without breaking existing functionality?

Incremental skill optimization involves proposing small, single changes guided by an eval rubric to measure success. This approach minimizes risk and includes a rollback plan to preserve existing functionality during updates.

What is an eval rubric for skill quality assurance?

An eval rubric for skill quality assurance is a set of 3–6 measurable criteria covering trigger quality, task fidelity, safety, and output conformance. It establishes explicit success metrics to evaluate target skill improvements.

How do I audit a Claude Code skill to find improvement opportunities?

Audit a Claude Code skill by inspecting its current package, invocation settings, and examples. This baseline audit identifies concrete weaknesses and scopes changes to small, testable updates.

Can I reduce over-triggering in a skill prompt while preserving its task fidelity?

Yes, you can tighten a skill's prompts to reduce over-triggering while preserving functionality. Incremental optimization proposes single changes linked to an eval hypothesis to measure trigger quality and task fidelity.

What is the best way to plan a rollback for a skill optimization update?

Plan a rollback for a skill optimization update by defining risk management rules and a clear evaluation plan beforehand. This prevents regressions by ensuring failed incremental changes can be safely reverted.