sk-improve-agent

Coordinate evaluator-first agent improvement with 5-dimension scoring and guarded promotion.

31|3|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/MichelKerkmeester/opencode--spec-kit-skilled-agent-orchestration --skill sk-improve-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sk-improve-agent
Source: https://github.com/MichelKerkmeester/opencode--spec-kit-skilled-agent-orchestration/tree/main/.opencode/skill/sk-improve-agent
Command: npx skills add https://github.com/MichelKerkmeester/opencode--spec-kit-skilled-agent-orchestration --skill sk-improve-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill enables an evaluator-first loop to improve bounded agent surfaces safely, preventing direct canonical edits and ensuring evidence-backed changes.

Core Features & Use Cases

  • 5-dimension scoring across structural integrity, rule coherence, integration consistency, output quality, and system fitness to quantify improvements.
  • Dynamic target profiling that derives evaluation rules from the agent's own frontmatter and policy, enabling on-the-fly scoring for any agent in the repository.
  • Guarded promotion and rollback with append-only evidence, traceable benchmarks, and memory artifacts that support auditable decisions.
  • Integration-scanning and drift visibility to keep runtime mirrors aligned while preserving evaluation truth.

Quick Start

Run a complete improve-agent loop against a target agent path to produce a packet-local candidate and associated evidence before mutating the canonical target.

Frequently Asked Questions about sk-improve-agent

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

FAQPage Schema
How do I safely improve agent behavior without directly modifying the canonical target files?▼

To safely improve agent behavior without mutating canonical targets, use an evaluator-first loop that derives a dynamic profile, scores improvements across 5 dimensions, and records append-only artifacts for promotion decisions. This ensures changes remain evidence-backed and reversible.

What is dynamic profiling for agent evaluation and how does it work?▼

Dynamic profiling for agent evaluation derives scoring rules directly from the agent's own frontmatter and policy. It enables on-the-fly evaluation by generating a target-specific profile, ensuring the 5-dimension scoring accurately reflects the unique characteristics of any agent in the repository.

How do I score agent performance across multiple dimensions before promoting changes?▼

You score agent performance using a 5-dimension framework covering structural integrity, rule coherence, integration consistency, output quality, and system fitness. This quantifies improvements before promotion, ensuring that only evidence-backed changes are promoted to the canonical target.

Can I evaluate and improve any agent defined in my repository?▼

Yes, you can evaluate any agent defined in the .opencode/agent directory. The system dynamically profiles the target agent path and applies deterministic benchmarks to generate a packet-local candidate with associated evidence, regardless of the specific agent configuration.

Does the agent improvement workflow support rollback if a promotion fails?▼

Yes, the workflow supports guarded promotion and rollback using append-only evidence and memory artifacts. This ensures auditable decisions and safe recovery, keeping runtime mirrors aligned while preserving evaluation truth if a promoted change needs to be reversed.

When should I avoid using an evaluator-first loop for agent improvement?▼

You should avoid using an evaluator-first loop if your workflow requires immediate canonical edits without traceable benchmarks or append-only evidence. The system is designed for bounded, auditable improvements, so direct mutation workflows bypass its core safety boundaries.