system-self-improve

Proposes minimal reversible edits to audit skills based on review gap reports.

3|5|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill system-self-improve-bensheridanedwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-self-improve
Source: https://github.com/BenSheridanEdwards/ArchitectPlaybook/tree/main/system-self-improve
Command: npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill system-self-improve-bensheridanedwards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a code review surfaces a gap that an audit skill missed, there is no systematic way to feed that learning back into the audit itself. This Skill closes that loop by reading gap reports, locating the responsible audit's SKILL.md, and proposing a minimal reversible edit so the same class of gap is caught next time. ## Core Features & Use Cases - Gap-driven improvement: Accepts three input modes — a review gap report file, a user-supplied gap description with a target skill, or pattern analysis across audit-history findings. - Safe mutation workflow: Dry-run by default, producing an improvement plan and unified diff; the --apply mode always requires explicit human confirmation before editing any file. - Cross-skill consistency: Coordinates ripple-effect updates across README indexes, boundary tables, CLAUDE.md rules, and MEMORY.md when an audit evolves. - Use Case: A reviewer finds that the security audit missed prompt() as an XSS vector. Run this Skill against the gap report to generate a plan that adds the missing check to security-audit/SKILL.md, updates the README summary, and drafts a Conventional Commits message. ## Quick Start Run /system-self-improve from inside the architect-playbook clone to scan for review gap reports and generate a dry-run improvement plan.

Frequently Asked Questions about system-self-improve

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

FAQPage Schema
How do I improve an audit skill after a review finds a gap?

Write a review-gap-report.md into the originating audit's .architect-audits directory, then run /system-self-improve from the playbook clone. It classifies the gap, locates the affected SKILL.md sections, and proposes a minimal diff for your approval.

What input modes does system-self-improve support?

Three modes in priority order: a review gap report file, a --gap description paired with --target-skill, or --from-audit-history which scans findings.json files for systematic patterns. The first mode yielding usable input wins.

Can system-self-improve edit files without confirmation?

No. Dry-run is the default and only writes plan files. Even with --apply, the skill prints the diff and requires an explicit yes before mutating anything, and there is deliberately no flag to bypass the confirmation prompt.

Why does system-self-improve fail with 'not a playbook clone'?

The skill must run inside an architect-playbook clone or be pointed at one via --playbook-path. It detects the clone by checking for a README mentioning architect-playbook, a CLAUDE.md, and at least one skill-name/SKILL.md directory.

What changes is system-self-improve not allowed to make?

It never deletes checks or skills, never changes the four-layer structure, two-phase flow, or status taxonomy conventions, never edits target-project files, and never commits to git. Proposed diffs over 50 lines are rejected as too large for self-improvement.