← Back to Skills Marketplace
Reflect
by
Steven Gonsalvez
· GitHub ↗
· v2.1.0
8031
Downloads
14
Stars
64
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 a skill that can preserve conversation-derived learnings across sessions and projects. Review proposed diffs carefully, avoid approving learnings that contain secrets or private content, consider setting REFLECT_STATE_DIR to a project-local/private location, and do not enable the hook or auto-reflection until you are comfortable with the local files it writes.
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 is self-improvement through conversation analysis, and the main capabilities fit that purpose, but they include Write/Edit/Bash access, creation of new skill files, proposed agent-file changes, optional git commits, hook integration, and cross-project reflection archives.
Instruction Scope
The skill documents human approval before applying agent or skill changes, but activation conditions include corrections, successful patterns, session ending, and context compaction, and helper scripts can persist reflection artifacts and indexes as part of generation.
Install Mechanism
No automatic installer was found, but the package includes optional hook scripts and settings snippets for user-level Claude hooks. It also ships unrelated scripts/logs session artifacts, including a large chat log and hook event logs, which are not necessary for installation.
Credentials
Project-local files are expected, but default/global writes under ~/.reflect, ~/.claude/session, ~/.claude/reflections, and ~/.claude/logs aggregate session-derived content, source quotes, session metadata, and project paths across contexts.
Persistence & Privilege
Persistence is core to the skill, but it is broad: learnings logs, pending reviews with source quotes, reflection files, global indexes, per-agent archives, hook logs, optional new skills, and optional git commits. There is no evidence of exfiltration or destructive runtime 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 8031 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