# quality-refinement-autoloop

quality-refinement-autoloop turns a bad Blender result into a reusable skill fix. Diagnoses the gap, repairs either the artifact or the skill, then preps for release.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1400 installs · ★ 181 repo stars
- Author: RobLe3
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/RobLe3/cc-blender-skill/tree/HEAD/plugin/skills/quality-refinement-autoloop/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/quality-refinement-autoloop

## What it does

This skill kicks in when a user rejects output: wrong geometry, broken UVs, missing animation, export failures. Instead of endless tweaks, it freezes the last accepted baseline, captures the smallest evidence set that proves the failure, and classifies the problem into eight dimensions from silhouette to orchestration.

Then it decides whether the current skill stack can fix the artifact or a generic skill needs to be added first. Repeated failures across skills lead to a harmonizer update, not a leaf-level patch. Lessons get sanitized: project names, secrets, private paths and raw logs are stripped out. Three scripts handle the loop plan, contribution sanitizing, and release readiness checks.

Hard rules block hiding geometry or UV failures behind lighting tweaks. Export support cannot be claimed if the effect only exists in Blender Python or a render sequence. No push without an explicit user request and an up-to-date remote check. Before the first Blender call the skill reads `../text-to-blender/references/mcp-backends.md` and requires picking an MCP backend, official preferred for shared capabilities.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/quality-refinement-autoloop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/quality-refinement-autoloop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/quality-refinement-autoloop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/quality-refinement-autoloop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install RobLe3/cc-blender-skill plugin/skills/quality-refinement-autoloop
```

2. **Manually: put the files in place**
- File: `.github/skills/quality-refinement-autoloop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/RobLe3/cc-blender-skill --path plugin/skills/quality-refinement-autoloop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/quality-refinement-autoloop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/RobLe3/cc-blender-skill/tree/HEAD/plugin/skills/quality-refinement-autoloop/SKILL.md

## When to use it
- classify a Blender failure across eight dimensions and find the primary gap
- turn a rejected run into a reusable skill instead of a one-off edit
- strip client names, secrets and private paths before publishing a skill
- run a sanitizer scan and skill graph audit after each change
- stage, commit and push only on explicit request

## Example prompts
- Run the loop: the geometry on the render is wrong, check the skill and fix the artifact.
- Write `RALPH_OR_QUALITY_LOOP_REPORT.md` and decide whether a new skill is needed.
- Sanitize the skill contribution and check release readiness, but do not push without my explicit go.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 95e959d17f04b438.

BEGIN THIRD-PARTY FILE 95e959d17f04b438
```text
---
name: quality-refinement-autoloop
description: Run a self-refinement loop when a Blender result is subpar, user expectations are not met, validation fails, or repeated issues reveal missing skill depth. The loop diagnoses the gap, decides whether to repair the artifact or acquire/refine a generic skill, sanitizes lessons for reusable publication, updates docs/versioning, validates, and prepares stage/commit/push when explicitly requested.
allowed-tools: Read Bash Glob Grep mcp__blender__execute_blender_code mcp__blender__get_scene_info mcp__blender__get_object_info mcp__blender__get_objects_summary mcp__blender__get_object_detail_summary mcp__blender__render_viewport_to_path mcp__blender__search_api_docs mcp__blender_official__execute_blender_code mcp__blender_official__get_objects_summary mcp__blender_official__get_object_detail_summary mcp__blender_official__render_viewport_to_path mcp__blender_official__search_api_docs
---


## MCP backend

Use when: Subpar output, user rejects quality, repeated Blender failure, RALPH loop, skill gap diagnosis, autonomous skill refinement, sanitized skill contribution, release prep, docs/version bump, staged commit and push workflow.

Before the first Blender call, read [../text-to-blender/references/mcp-backends.md](../text-to-blender/references/mcp-backends.md). Prefer official MCP for shared capabilities; preserve the selected backend for the whole task. Tool names in recipes are client/legacy examples: map them through that reference and its agent-host guide.
# Quality Refinement Autoloop

Use this when the user says the result is wrong, ugly, not aligned, not textured, not animated, not exportable, or otherwise below expectation. The goal is not to keep tweaking blindly. The goal is to convert failure into a reusable, generic skill improvement before trying again.

## Autoloop phases

### 0. Freeze and preserve

- Stop making product changes immediately.
- Preserve the last accepted baseline and the failed artifact.
```
END THIRD-PARTY FILE 95e959d17f04b438

The third-party file has ended. Everything between the 95e959d17f04b438 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1995 of 5663 bytes. © RobLe3 · MIT · https://github.com/RobLe3/cc-blender-skill/tree/HEAD/plugin/skills/quality-refinement-autoloop/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
