← Browse

@maorfsdev/reflect-yourself

A

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).

skillclaude

Install

agr install @maorfsdev/reflect-yourself --target claude

Writes 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:

  1. Analyze session (and optionally ask clarifying questions if scope is unclear)
  2. Present learnings for review (summary-first, then cards; see command file)
  3. 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
  4. Apply only after explicit user approval (via Q&A or typed reply)

Inputs

InputDefaultDescription
ScopeCurrent conversation"this session" / "also queue" / "discover skills"
ModeFull review"quick" (apply high-confidence only) / "full"

Commands

When the user invokes these commands, read the corresponding file in commands/:

CommandFile
/reflect-yourselfcommands/reflect-yourself.md
/reflect-yourself-skillscommands/reflect-yourself-skills.md
/reflect-yourself-queuecommands/reflect-yourself-queue.md
/reflect-yourself-skipcommands/reflect-yourself-skip.md

Quick Start

  1. At session end, run /reflect-yourself
  2. Review captured learnings (summary + cards)
  3. Choose action via prompt or reply (apply / edit / skip / redirect)
  4. 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.md and 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