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.