@maorfsdev/reflect-yourself
ASelf-learning system that captures corrections, discovers workflow patterns, and syncs learnings to skills and rules. Use when ending a session, after corrections, or when the user wants to formalize learnings (v1.1.3).
Install
agr install @maorfsdev/reflect-yourself --target claudeWrites 7 files into .claude/skills/, pinned to git-04c09856.
- .claude/skills/reflect-yourself/.gitignore
- .claude/skills/reflect-yourself/LICENSE
- .claude/skills/reflect-yourself/README.md
- .claude/skills/reflect-yourself/SKILL.md
- .claude/skills/reflect-yourself/install.ps1
- .claude/skills/reflect-yourself/install.sh
- .claude/skills/reflect-yourself/package.json
Document
name: reflect-yourself description: Self-learning system that captures corrections, discovers workflow patterns, and syncs learnings to skills and rules. Use when ending a session, after corrections, or when the user wants to formalize learnings (v1.1.3).
reflect-yourself
A self-learning system for Cursor that captures corrections and syncs them to the right place.
Workflow
When invoked:
- Analyze session (and optionally ask clarifying questions if scope is unclear)
- Present learnings for review (summary-first, then cards; see command file)
- Capture action via the Cursor agent tool Ask questions (message-question) when possible — offer Apply all / Apply selected / Skip all / Partial / Other; see Cursor docs → Agent overview → Tools
- Apply only after explicit user approval (via Q&A or typed reply)
Inputs
| Input | Default | Description |
|---|---|---|
| Scope | Current conversation | "this session" / "also queue" / "discover skills" |
| Mode | Full review | "quick" (apply high-confidence only) / "full" |
Commands
When the user invokes these commands, read the corresponding file in commands/:
| Command | File |
|---|---|
/reflect-yourself | commands/reflect-yourself.md |
/reflect-yourself-skills | commands/reflect-yourself-skills.md |
/reflect-yourself-queue | commands/reflect-yourself-queue.md |
/reflect-yourself-skip | commands/reflect-yourself-skip.md |
Quick Start
- At session end, run
/reflect-yourself - Review captured learnings (summary + cards)
- Choose action via prompt or reply (apply / edit / skip / redirect)
- Learnings are applied to skills/rules after approval
Placement Logic
- Project Skills (
.cursor/skills/) → Codebase-specific - Personal Skills (
~/.cursor/skills/) → Reusable across projects - Project Rules (
.cursor/rules/) → Coding standards
Queue Location
Pending learnings: ~/.cursor/reflect-queue.json (global location, never pollutes project repos)
Security
- Trust model: Only install skills from sources you trust. Skills are loaded into the agent context and can influence behavior.
- Import hygiene: Prefer official or well-known repos; inspect
SKILL.mdand command/rules files before installing. Be wary of skills that instruct the agent to run arbitrary code or exfiltrate data. - This skill: Only instructs the agent to write to
.cursor/skills/,.cursor/rules/, and~/.cursor/skills/. The installer copies files only; it does not execute skill content. After install, review~/.cursor/skills/reflect-yourself/if you want to verify contents.
Update check
When main commands are run, the agent may check for a newer npm version. If one exists, the user can be prompted (Yes/No) to run npx reflect-yourself@latest. See command files for details.
Trustgrade A
- passBody integrity
Whether the stored document is plausibly the kind of file the artifact declares, rather than something fetched by mistake.
- passType matchnot applicable to this artifact type
Whether the artifact is really the kind of thing its metadata claims it is.
- passFreshness
How long since the source repository was last pushed to.
- passPrompt injection
Scans the artifact's own text for instructions aimed at your agent rather than at you.
- passLicense
Whether the source repository declares an SPDX license permissive enough to redistribute.
How the grade is calculated
Each check contributes 0 points when it passes, 1 when it warns, and 2 when it fails. The total maps to a letter:
- Aevery check passed
- Bone warning
- Ctwo warnings
- Dprompt injection or body integrity failed, or three warnings
- Fone of those failed, and something else is wrong
These are automated hygiene checks, not a security audit, and not a dependency or vulnerability scan. A grade of A means nothing was flagged — not that the artifact is safe.
Versions
git-04c09856ea482026-07-31