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

  • Manifest — Real-time cost observability for OpenClaw agents — track tokens, costs, messages, and model usage 4.1k ★
  • WindsurfAPI — Turn Windsurf / Devin Desktop's 100+ AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, A 3k ★
  • Ante — Ghost in your shell 1.9k ★

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