← Back to Skills Marketplace
Reflect
by
Steven Gonsalvez
· GitHub ↗
· v2.1.0
8587
Downloads
14
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install reflect-learn
Description
Self-improvement through conversation analysis. Extracts learnings from corrections and success patterns, proposes updates to agent files or creates new skil...
Usage Guidance
Install only if you want an agent to keep durable learning records and propose persistent behavior changes. Review every proposed diff before approving, avoid enabling auto-reflection unless you are comfortable with files being created during compaction, and periodically inspect or delete ~/.claude/reflections, ~/.reflect, and any generated .claude/skills entries.
Capability Analysis
Type: OpenClaw Skill
Name: reflect-learn
Version: 2.1.0
The skill is designed for agent self-improvement, allowing it to analyze conversations, propose updates to its own configuration files, and create new skills. While this involves powerful capabilities like modifying agent files, creating new skill definitions, and using the `Bash` tool, the `SKILL.md` explicitly outlines strong safety guardrails, including mandatory human approval for all proposed changes, Git versioning for easy rollbacks, and incremental updates. The Python scripts handle file operations within expected `.claude/` and `~/.reflect/` directories, and there is no evidence of data exfiltration, unauthorized persistence, or malicious execution beyond the stated purpose. The instructions themselves do not contain prompt injection attempts to bypass security or hide actions.
Capability Assessment
Purpose & Capability
The stated purpose matches the capabilities: it analyzes conversations, proposes durable agent updates, creates new skills, and uses Read/Write/Edit/Grep/Glob/Bash. The concern is that this is high-impact self-modification and cross-session memory behavior, not that it is hidden or unrelated.
Instruction Scope
SKILL.md requires explicit approval before applying agent changes and shows diffs, but it also frames session end, context compaction, and broad success patterns as use cases. Detection patterns include common approval phrases, which can overinterpret ordinary conversation unless the user carefully reviews proposals.
Install Mechanism
The package includes hook installation examples and executable Python helpers, but no evidence of network exfiltration, obfuscation, package-install abuse, or automatic installation during review. Bundled development log JSON exposes session paths and prompt history, which is poor packaging hygiene but not a direct user-system compromise.
Credentials
The global reflection store under ~/.claude/reflections, by-project copies, by-agent learnings, exact source quotes, project paths, and proposed diffs are broader than a project-local reflection workflow and can retain sensitive conversation or project context across unrelated work.
Persistence & Privilege
The skill can update agent behavior, create .claude/skills/{name}/SKILL.md, commit changes, maintain state under ~/.reflect or ~/.claude/session, and install a PreCompact hook. These are purpose-aligned but require careful user control because they persist and can affect future agent behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install reflect-learn - After installation, invoke the skill by name or use
/reflect-learn - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
Add Security category to signal detection, fix agent_mappings.md root-level agents, add Memory integration guidance, consistency fixes across reference files
v2.0.0
- Updated skill.
Metadata
Frequently Asked Questions
What is Reflect?
Self-improvement through conversation analysis. Extracts learnings from corrections and success patterns, proposes updates to agent files or creates new skil... It is an AI Agent Skill for Claude Code / OpenClaw, with 8587 downloads so far.
How do I install Reflect?
Run "/install reflect-learn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Reflect free?
Yes, Reflect is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Reflect support?
Reflect is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Reflect?
It is built and maintained by Steven Gonsalvez (@stevengonsalvez); the current version is v2.1.0.
More Skills