skill-improvement-planner

Aggregates skill reflection files into a structured improvement plan for downstream skill editors.

2|1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Consiliency/agent-harness --skill skill-improvement-planner-consiliency
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improvement-planner
Source: https://github.com/Consiliency/agent-harness/tree/main/phase-loop-skills/skill-improvement-planner
Command: npx skills add https://github.com/Consiliency/agent-harness --skill skill-improvement-planner-consiliency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Teams running AI workflow skills accumulate reflection files after each run, but turning that scattered feedback into concrete SKILL.md edits is manual and error-prone. This Skill reads those reflections, finds recurring themes, and produces a structured improvement plan without touching the skills themselves. ## Core Features & Use Cases - Reflection aggregation: Enumerates unarchived reflection files across harness skill roots, parses What worked and Improvements to SKILL.md sections, and gates on a minimum-evidence threshold. - Theme grouping and contradiction surfacing: Groups recurring recommendations by skill, separates actionable changes from speculative notes, and flags contradictory feedback instead of silently resolving it. - Plan generation with handoff: Writes a versioned plan file listing consumed reflections, cross-cutting recommendations, and an archival directive for the downstream skill-editor, plus repo-local handoff state. - Use Case: After several phase-loop runs, invoke the planner to audit accumulated reflections for the roadmap-builder, plan-phase, and execute-phase skills and receive a single plan file the skill-editor can apply. ## Quick Start Ask the assistant to review the accumulated skill reflections and produce an improvement plan for the workflow skills, optionally targeting one skill with --target.

Frequently Asked Questions about skill-improvement-planner

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

FAQPage Schema
How do I aggregate AI skill reflections into an improvement plan?▼

Invoke the skill-improvement-planner, which enumerates unarchived reflection files under each skill's reflections directory, parses their feedback sections, and writes a versioned plan file grouping recurring recommendations by skill.

What is the minimum number of reflections needed before planning?▼

The default threshold is 2 reflections per skill, configurable with --min-reflections. Skills below the threshold are skipped and noted in the plan summary; zero reflections total produces a nothing-to-aggregate report.

Does the skill-improvement-planner edit SKILL.md files directly?▼

No. It is planning-only and never modifies SKILL.md files. The downstream skill-editor consumes the plan, applies the approved edits, and archives the consumed reflections.

Can I generate a plan for only one skill?▼

Yes. Pass --target <skill-name> to limit enumeration and aggregation to a single skill instead of the default set of pipeline and meta-skills.

How are contradictory reflection recommendations handled?▼

Contradictions are surfaced in a dedicated plan section naming both sides and their supporting reflections. The planner never resolves disagreements silently; the user decides which direction to take.