skill-tuning

Diagnose and optimize multi-phase skill execution workflows with rollback support.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/tcytan/tecton --skill skill-tuning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-tuning
Source: https://github.com/tcytan/tecton/tree/main/.claude/skills/skill-tuning
Command: npx skills add https://github.com/tcytan/tecton --skill skill-tuning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ccw cli.

What problem does it solve?

This Skill helps identify and fix common failure modes in multi-phase, tool-using skills—especially issues like context explosion, long-tail forgetting, broken state/data flow, and fragile agent coordination.

Core Features & Use Cases

  • Universal skill diagnosis: Detects anti-patterns across context handling, memory/constraints retention, state consistency, agent call robustness, documentation drift, and token consumption.
  • Actionable optimization workflow: Produces prioritized fix proposals, applies selected fixes with backups/rollback capability, and verifies improvements via re-diagnosis/quality gates.
  • Gemini-assisted deep analysis: Triggers on critical or uncovered areas to perform deeper root-cause or architecture/prompt/performance reviews when pattern-based checks are insufficient.

Quick Start

Run skill tuning on the target skill directory by asking the skill to diagnose the command "Fix memory leaks in my skill".

Frequently Asked Questions about skill-tuning

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

FAQPage Schema
How do I fix context explosion and long-tail forgetting in multi-phase agent skills?

To fix context explosion and long-tail forgetting in multi-phase agent skills, you need to diagnose anti-patterns in context handling and memory retention. Universal workflow diagnosis detects these issues and applies targeted optimizations with rollback capabilities to restore state consistency.

What is the best way to diagnose broken state consistency and fragile agent coordination?

The best way to diagnose broken state consistency and fragile agent coordination is through pattern-based workflow checks that detect anti-patterns across memory, constraints, and agent call robustness. Deep root-cause analysis triggers when standard checks are insufficient.

How do I optimize token consumption and constraint retention for autonomous workflows?

To optimize token consumption and constraint retention for autonomous workflows, run a diagnostic workflow that analyzes token growth and state management. It produces prioritized fix proposals and verifies improvements through quality-gate validation.

Does skill tuning work with YAML-defined entry metadata and state-driven orchestration?

Yes, skill tuning works with YAML-defined entry metadata and state-driven orchestration. It requires these structures to perform universal diagnosis, apply fix strategies, and execute quality-gate verification with safe backup and rollback semantics.

Can I use Gemini CLI for deep architecture and performance reviews when pattern checks fail?

Yes, you can use Gemini CLI for deep architecture and performance reviews when pattern checks fail. Gemini-assisted deep analysis triggers on critical or uncovered areas to perform root-cause reviews when standard diagnostics are insufficient.

Why does my multi-phase skill fail output validation and documentation drift checks?

Your multi-phase skill fails output validation and documentation drift checks due to anti-patterns in state management and tool usage. Diagnostic categories identify these failure modes, enabling you to apply fixes and verify reliability through re-diagnosis.