Thomaszhou22

Self Refine Skill — AI skill for Claude Code

AI community

🪞 Systematic self-reflection for AI agents.

How to install Self Refine Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Thomaszhou22/self-refine-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Self Refine Skill does

🪞 Systematic self-reflection for AI agents. GENERATE → CRITIQUE → REFINE → CHECK. Based on peer-reviewed research. Zero API cost. Works with Claude Code, Cursor, Copilot, Codex CLI, and 10+ more platforms.

Alternatives in AI

  • Oil UI — Push AI UI design to its limits: explore distinct directions, compare them side by side, and refine against re 861 ★
  • The Pair — Open-source AI pair programming for desktop: a Mentor + Executor agent cross-check each other's code to catch 358 ★
  • Tokentab — A CLI that reads Claude Code, Codex, and Gemini CLI session logs and works out how much they cost, by model, p 226 ★

README

🪞 Self-Refine Skill

**Systematic self-reflection for AI agents.**

*Make every AI response better — before the user sees it.*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![OpenClaw](https://img.shields.io/badge/OpenClaw-compatible-blue)](https://openclaw.ai) [![Claude Code](https://img.shields.io/badge/Claude%20Code-compatible-purple)](https://claude.ai) [![Cursor](https://img.shields.io/badge/Cursor-compatible-orange)](https://cursor.sh) [![GitHub Copilot](https://img.shields.io/badge/Copilot-compatible-lightblue)](https://github.com/features/copilot) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-compatible-green)](https://github.com/openai/codex) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-compatible-4285F4)](https://ai.google.dev) [![Windsurf](https://img.shields.io/badge/Windsurf-compatible-00D4AA)](https://codeium.com/windsurf) [![JetBrains](https://img.shields.io/badge/JetBrains-compatible-000)](https://www.jetbrains.com/ai/) [![Benchmarked](https://img.shields.io/badge/benchmarked-21%25%20improvement-green)](BENCHMARK.md)


What It Does

Most AI responses are first drafts. This skill adds an **invisible self-review step** before every response:

GENERATE → CRITIQUE → REFINE → CHECK → DELIVER

Based on peer-reviewed research showing **~20% quality improvement** from iterative self-refinement (Madaan et al., 2023).

**One file. Zero dependencies. Zero API cost.** The host AI acts as its own critic.


Proven Results

Benchmarked on **20 questions across 5 categories** with controlled before/after evaluation. → [Full report](BENCHMARK.md)

Metric Result
Overall improvement +21.2%
Questions improved 20/20 (100%)
Best single improvement +43.9%

**Per-dimension improvement:**

Dimension Δ
Conciseness +27.7%
Actionability +25.0%
Response Completeness +24.8%
L