A self-learning system for Claude Code that captures corrections, positive feedback, and preferences — then syncs them to CLAUDE.md and AGENTS.md.
SaferSkills independently audited claude-reflect (Agent Skill) and scored it 96/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 1 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A two-stage system that helps Claude Code learn from user corrections.
Stage 1: Capture (Automatic) Hooks detect correction patterns ("no, use X", "actually...", "use X not Y") and queue them to ~/.claude/learnings-queue.json.
Stage 2: Process (Manual) User runs /reflect to review and apply queued learnings to CLAUDE.md files.
| Command | Purpose |
|---|---|
/reflect | Process queued learnings with human review |
/reflect --scan-history | Scan past sessions for missed learnings |
/reflect --dry-run | Preview changes without applying |
/reflect-skills | Discover skill candidates from repeating patterns |
/skip-reflect | Discard all queued learnings |
/view-queue | View pending learnings without processing |
Remind users about /reflect when:
High-confidence corrections:
~/.claude/CLAUDE.md - Global learnings (model names, general patterns)./CLAUDE.md - Project-specific learnings (conventions, tools, structure)./CLAUDE.local.md - Personal learnings (machine-specific, gitignored)./.claude/rules/*.md - Modular rules with optional path-scoping~/.claude/rules/*.md - Global modular rules~/.claude/projects/<project>/memory/*.md - Auto memory (low-confidence, exploratory)commands/*.md - Skill improvements (corrections during skill execution)User: no, use gpt-5.1 not gpt-5 for reasoning tasks
Claude: Got it, I'll use gpt-5.1 for reasoning tasks.
[Hook captures this correction to queue]
User: /reflect
Claude: Found 1 learning queued. "Use gpt-5.1 for reasoning tasks"
Scope: global
Apply to ~/.claude/CLAUDE.md? [y/n]~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.