improve

Analyze skill outcomes and user corrections to propose targeted SKILL.md improvements.

16|9|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/sonthanh/brain-os-plugin --skill improve-sonthanh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve
Source: https://github.com/sonthanh/brain-os-plugin/tree/main/skills/improve
Command: npx skills add https://github.com/sonthanh/brain-os-plugin --skill improve-sonthanh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze skill outcomes and user corrections to propose self-improvements. Use when a skill's output repeatedly needs manual fixes, after a grill session surfaces skill weaknesses, or on a schedule to continuously improve skill quality.

Core Features & Use Cases

  • Automates learning loops by evaluating outcomes, corrections, and grill sessions to surface concrete improvement tasks.
  • Coordinates Phase 0–5 workflow: memory triage, index reconciliation, expiry, pattern extraction, and variant generation to update SKILL.md and evals.
  • Use Case: when a skill underperforms, /improve identifies top improvement targets, encodes changes, and tracks eval results so improvements are auditable.

Quick Start

Run /improve to trigger the learning loop on a specific skill or to scan all outcomes and identify top candidates for improvement.

Frequently Asked Questions about improve

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

FAQPage Schema
How do I automate skill improvements from user corrections and outcomes?

To automate skill improvements, this Skill analyzes outcomes and user corrections to propose targeted behavior changes. It runs an end-to-end learning loop covering memory triage, evaluation, and SKILL.md updates in a reproducible, auditable manner.

What is the best way to update skill behavior after a grill session surfaces weaknesses?

Updating skill behavior after a grill session involves identifying top improvement targets and encoding changes through versioned commits. The workflow enforces strict gates and an evaluative framework to ensure modifications are beneficial and safe.

How does the evaluation framework ensure changes to skills are safe and auditable?

The evaluation framework ensures changes are auditable by enforcing strict gates, tracking eval results, and using versioned commits. This reproducible process guarantees that all proposed self-improvements are verified as beneficial before integration.

When should I run an automated learning loop to fix underperforming skills?

You should run an automated learning loop when a skill's output repeatedly needs manual fixes, after a grill session surfaces weaknesses, or on a schedule to continuously improve skill quality and reliability across memory triage and pattern extraction.

Can I continuously improve skill quality without manual intervention?

You can continuously improve skill quality by running the learning loop on a schedule. It automatically scans all outcomes, identifies top candidates for improvement, extracts patterns, and generates variants to update SKILL.md and evals.

What are the limitations of using version control for skill reliability updates?

Limitations of using version control for updates include strict enforcement gates that may reject changes if eval results are not beneficial. The process requires passing an evaluative framework before any versioned commits update the skill behavior.