gemini-skill-improvement-planner

Run the planner with an optional --target skill name; it scans unarchived reflections under the Gemini and codex-derived skill roots, groups recurring themes, and writes a Markdown plan. It requires at least two reflections per skill by default before making recommendations.

No, the planner only produces a plan document. The gemini-skill-editor skill applies the plan and handles archiving the consumed reflections, keeping planning and editing as separate steps.

Skills with fewer reflections than the --min-reflections threshold (default 2) are recorded as skipped, and zero reflections overall results in a report that there is nothing to aggregate. One-off feedback is ignored unless explicitly requested.

Contradictions are surfaced in a dedicated plan section rather than resolved silently. This lets the reviewer or gemini-skill-editor decide which direction to take with full visibility of the conflicting evidence.

It scans reflections under the Gemini skill bundle root and the codex-derived source-controlled reflection root, excluding any path containing an archive component. Paths are resolved through the phase_loop_runtime skill_paths resolver helpers.