optimize-skill

Optimize AI agent skill instructions through structured eval cycles and baseline verification.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill optimize-skill-artk0de
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-skill
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude/skills/optimize-skill
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill optimize-skill-artk0de

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the degradation of agent performance caused by stale, verbose, or poorly routed instructions, ensuring your skills remain highly effective and reliable.

Core Features & Use Cases

  • Structured Eval Cycles: Uses parallel subagents to measure skill performance against baseline metrics.
  • Automated Verification: Implements a rigorous audit-baseline-fix-verify loop to ensure 100% pass rates.
  • Use Case: When a coding agent consistently selects the wrong tool for a specific task, use this skill to audit the instructions, run comparative evaluations, and iterate until the agent consistently chooses the correct tool.

Quick Start

Invoke the optimize-skill tool by providing the file path to the specific SKILL.md file you wish to improve.

Frequently Asked Questions about optimize-skill

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

FAQPage Schema
How do I fix an AI agent selecting the wrong tool for a task?

To fix incorrect tool selection in AI agents, use an eval-driven optimization methodology to audit the skill instructions, run comparative baseline evaluations, and iterate until the agent consistently chooses the correct tool.

What is eval-driven optimization for agent skills?

Eval-driven optimization improves AI agent skills by systematically measuring baseline performance, testing against defined cases, and refining instruction routing and conciseness to ensure measurable performance gains.

How do I benchmark AI agent workflow performance against a baseline?

Benchmark agent workflow performance by running parallel subagents to measure current skill metrics, then applying an audit-baseline-fix-verify loop to guarantee a 100% pass rate against defined test cases.

Can I optimize agent routing logic without writing manual test cases?

Optimizing routing logic requires defined test cases for systematic baseline measurement and verification, ensuring that any improvements to complex agent workflows are verified against baseline metrics.

What is the best way to reduce verbose instructions in agent workflows?

The best way to reduce instruction verbosity is an automated verification loop that targets instruction conciseness, auditing existing skills and fixing routing logic until measurable performance gains are achieved.

Why does my coding agent performance degrade with stale instructions?

Agent performance degrades with stale instructions due to poor routing logic and verbosity, requiring an eval-driven methodology to audit, fix, and verify skills against baseline metrics.