← Back to Skills Marketplace
sharoonsharif

reflexion

by Sharoon Sharif · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
150
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install reflexion
Description
Closed-loop learning for AI coding agents. Auto-captures errors and corrections, recalls relevant past solutions when similar situations arise, and promotes...
Usage Guidance
This skill appears to do what it says: it captures command outputs and user corrections and stores learnings under .reflexion/, recalls relevant entries before prompts, and can auto-append promoted rules to CLAUDE.md. Before installing, consider: (1) .reflexion/ contains captured command outputs and commands (the scripts attempt to redact tokens but redaction is heuristic and may miss things) — add .reflexion/ to your .gitignore and review entries before committing; (2) installing the hooks globally enables cross-project capture (privacy risk for multi-project/multi-user machines); (3) promoted rules will modify project files (CLAUDE.md) automatically when criteria are met — if you prefer manual control, run promote.sh manually rather than enabling background promotion; (4) the code requires common tools (git, python3) but no secrets; review the scripts yourself if you want to confirm redaction/behavior. Overall the skill is internally consistent and not requesting unexpected privileges or credentials.
Capability Analysis
Type: OpenClaw Skill Name: reflexion Version: 1.0.1 The reflexion skill bundle implements a local 'Verbal Reinforcement Learning' loop for AI agents, allowing them to capture command errors and recall solutions in future sessions. The scripts (capture.sh, recall.sh, promote.sh) operate entirely on the local filesystem within the project's .reflexion directory and include explicit logic to redact sensitive information like API keys and Bearer tokens before storage. The behavior is transparently documented and strictly aligned with the stated purpose of improving agent performance through episodic memory.
Capability Assessment
Purpose & Capability
Name/description (closed-loop learning for coding agents) match the provided scripts and SKILL.md. The hooks, capture, recall, promote, index rebuild and status scripts align with the declared functionality. Optional env var CLAUDE_PROJECT_ROOT and use of git/python3 are reasonable for determining project root and JSON handling. No extraneous credentials, network endpoints, or unrelated binaries are required.
Instruction Scope
SKILL.md instructs adding hooks that cause capture.sh to run after Bash tool use and recall.sh before prompts; the scripts implement that behavior and intentionally write entries to .reflexion/ and may append to CLAUDE.md. This is expected, but it means command outputs and commands (redacted heuristically) are captured and persisted in the repo. The SKILL.md example JSON includes a cwd field that the actual capture.sh does not produce — a minor documentation mismatch.
Install Mechanism
No install spec is present (instruction-only), so nothing is fetched from remote URLs. The skill is distributed as script files in the skill bundle; it relies on local copying or git clone per the docs. This is low risk from an install perspective.
Credentials
The skill declares no required environment variables or secrets. Runtime code optionally uses CLAUDE_PROJECT_ROOT to locate project root and checks for python3/git; these are proportional to its tasks. It does not request API keys or other credentials.
Persistence & Privilege
The skill writes persistent data into the project's .reflexion/ directory and may append promoted rules to CLAUDE.md. always is false and it does not change other skills' configs, but the recommended global hook installation (in ~/.claude/settings.json) would enable cross-project capture — consider this when installing globally. recall.sh also triggers promote.sh in the background which can modify project files during prompt handling.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install reflexion
  3. After installation, invoke the skill by name or use /reflexion
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Add paper citation: Shinn et al. (2023) Reflexion: Language Agents with Verbal Reinforcement Learning (arXiv:2303.11366)
v1.0.0
Initial release: closed-loop learning for AI coding agents. Auto-captures errors, recalls past solutions via keyword matching, auto-promotes recurring patterns to CLAUDE.md.
Metadata
Slug reflexion
Version 1.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is reflexion?

Closed-loop learning for AI coding agents. Auto-captures errors and corrections, recalls relevant past solutions when similar situations arise, and promotes... It is an AI Agent Skill for Claude Code / OpenClaw, with 150 downloads so far.

How do I install reflexion?

Run "/install reflexion" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is reflexion free?

Yes, reflexion is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does reflexion support?

reflexion is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created reflexion?

It is built and maintained by Sharoon Sharif (@sharoonsharif); the current version is v1.0.1.

💬 Comments