К основному содержанию
скилл CX Codex

quality-refinement-autoloop — скилл для Claude Code

Скилл quality-refinement-autoloop превращает неудачный результат Blender в исправление скилла. Диагностирует провал, чинит артефакт или сам скилл, готовит публикацию.

MIT 1 400 установок ★ 181 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a claude-code
Открыть на GitHub

Что делает quality-refinement-autoloop

Скилл запускается, когда пользователь отверг качество: кривая геометрия, плохие UV, нет анимации, не экспортируется. Вместо бесконечных правок он разбирает отказ на фазы: замораживает последний принятый результат, собирает улики, классифицирует провал по восьми измерениям.

Дальше решает: чинить артефакт существующим методом или сначала добавить новый скилл. Повторяющиеся ошибки между скиллами ведут к правке harmonizer-правила, а не отдельного листа. Урок чистят от имён проектов, секретов и путей, оставляя только переиспользуемый метод, гейты и паттерны отказа. Есть три скрипта: план цикла, сантайзер вкладов и проверка готовности релиза.

Жёсткие правила запрещают прятать геометрические провалы освещением и материалами. Экспорт заявлять нельзя, если эффект существует только в Blender Python. Пуш только после явной просьбы пользователя и проверки remote. Перед первым вызовом Blender скилл читает ../text-to-blender/references/mcp-backends.md и требует выбрать MCP-бэкенд: официальный предпочтителен для общих возможностей, выбранный сохраняется на всю задачу.

Какие задачи решает

  • разобрать провал Blender по восьми измерениям и найти главный пробел
  • превратить неудачный запуск в обобщённый скилл, а не в одноразовую правку
  • вычистить имена клиентов, секреты и приватные пути перед публикацией скилла
  • прогнать сантайзер и аудит скилл-графа после каждого изменения
  • подготовить stage, commit и push только по явной просьбе

Примеры запросов агенту

  • Запусти цикл: у меня кривая геометрия на рендере, проверь скилл и почини артефакт.
  • Собери отчёт RALPH_OR_QUALITY_LOOP_REPORT.md и реши, нужен ли новый скилл или хватит текущего.
  • Прогони сантайзер и проверь готовность релиза, но не пуши без моего явного «да».

Как установить quality-refinement-autoloop

1Через Skills CLI (Vercel)

npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a claude-code

2Вручную: положить файлы

~/.claude/skills/quality-refinement-autoloop/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/quality-refinement-autoloop/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о quality-refinement-autoloop

Как установить quality-refinement-autoloop в Claude Code?

Выполни npx skills add RobLe3/cc-blender-skill --skill quality-refinement-autoloop -a claude-code, затем открой ~/.claude/skills/quality-refinement-autoloop/SKILL.md.

Что делает quality-refinement-autoloop?

Ловит неудачные результаты Blender и разбирает их на цикл: диагноз провала, решение чинить артефакт или скилл, сантайз урока, валидация. Публикация и пуш — только по явной просьбе.

Какой MCP-бэкенд нужен для работы?

Скилл требует сначала прочитать ../text-to-blender/references/mcp-backends.md и выбрать бэкенд. Для общих возможностей предпочтителен официальный MCP, выбранный бэкенд сохраняется на всю задачу.

Исходный текст

SKILL.md · MIT
---
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.
- Name the failed branch/version honestly; do not overwrite accepted outputs.

### 1. Evidence capture

Collect the smallest evidence set that proves the failure:

- user feedback quote or summary;
- source/reference files used;
- current output path/version;
- relevant render/contact sheet/overlay/audit report;
- scene/material/object inventory if the failure is inside Blender.

### 2. Diagnose failure dimension

Classify the primary gap:

- geometry / silhouette / landmarks;
- multiview/depth consistency;
- UV / atlas / texture fit;
- closed surface coverage (front/back/side);
- look/material/lighting calibration;
- animation/motion/export truth;
- orchestration/handoff between skills;
- missing validator or missing deterministic helper script.

### 3. Skill-gap decision

Ask: does the current skill stack already contain a generic method for this failure?

- If yes: run the existing skill and repair the artifact.
- If no: add/refine a generic skill first, then repair.
- If repeated failures come from skill interplay, update the harmonizer/handoff rule, not just a leaf skill.

### 4. Sanitize the lesson

Before writing a skill change:

- remove project/client/asset names;
- remove secrets, raw logs, private paths, personal data, and copyrighted source content;
- keep only reusable method, gates, scripts, and failure patterns;
- describe inputs/outputs generically;
- prefer deterministic scripts for fragile audits.

### 5. Patch skill stack

Apply the smallest publishable change:

- one concise skill or one concise section in an existing skill;
- optional helper script if the validation is repeatable;
- harmonizer update if ordering/handoff changed;
- manifest entry/version update.

### 6. Validate skill change

Required checks:

- scripts compile;
- manifest paths exist;
- skill graph audit passes with harmonizer present;
- sanitizer scan passes for project-specific terms;
- if applicable, run the new helper against the failed artifact and save a report.

### 7. Repair product only after skill gate

Rebuild or repair from the correct baseline using the improved skill. Do not reuse rejected outputs unless explicitly marked as source evidence.

### 8. Release prep when requested

Only when the user asks to publish/commit/push:

1. fetch latest remote and confirm local branch is up to date;
2. resolve/harmonize conflicts before staging;
3. bump version using semver appropriate to scope;
4. update README / plugin README / CHANGELOG / VERSIONING when relevant;
5. run sanitizer and compile/audit checks;
6. stage, commit, and push using the configured remote.

## Hard rules

- Do not bake task-specific examples into public skills.
- Do not call overlay curves/planes “texture coverage” unless the real mesh surface also passes coverage gates.
- Do not tune lighting/materials to hide geometry or UV failures.
- Do not claim export support if the effect exists only in Blender Python or a render sequence.
- Do not push without an explicit user request and an up-to-date remote check.

## Recommended artifacts

Save these near the project output when running the loop:

- `RALPH_OR_QUALITY_LOOP_REPORT.md`
- `failure_evidence/` or references to existing renders/reports
- `skill_gap_decision.json`
- `sanitization_report.json`
- `validation_report.json`

## Scripts

- `scripts/ralph_autoloop_plan.py` creates a generic failure-classification and loop plan from feedback/artifact hints.
- `scripts/sanitize_skill_contributions.py` scans skill files for project-specific or private terms before publication.
- `scripts/release_readiness_check.py` performs lightweight manifest/docs/version/path checks before commit/push.

© RobLe3 · MIT · RobLe3/cc-blender-skill

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
Blender SFKislev Скилл Blender для Claude Code управляет открытой сценой Blender через локальный мост Flue. Агент читает объекты и материалы, а также выполняет небольшие скрипты bpy по запросу. CX Codex +1 2 900установок blender-mcp vladmdgolam Учит работать с Blender через MCP: инспектировать сцену, писать bpy-скрипты, экспортировать в GLB. Подключается при первом же вызове get_scene_info или execute_python. CX Codex +1 2 700установок scenario-blender-expert scenario-labs Скилл scenario-blender-expert для Claude Code помогает автоматизировать Blender через Python и MCP: моделировать, запекать, настраивать риг и проверять меши перед экспортом. CX Codex +1 1 700установок 3d-modeling omer-metin Скилл 3d-modeling для Claude Code, Codex, Cursor и других платформ, который добавляет агенту экспертизу старшего 3D-артиста. Охватывает топологию, UV-развёртку, ретопологию, LOD-системы и пайплайны экспорта в FBX и glTF. CX Codex +1 1 300установок scenario-blender-rigging scenario-labs Скилл scenario-blender-rigging для риггинга персонажа, существа или пропа в Blender через Python: метариг Rigify, веса, IK/FK, лицевой риг. CX Codex +1 1 200установок cli-anything-blender HKUDS Скилл cli-anything-blender для Claude Code, Cursor и других платформ, который даёт агенту командную строку для редактирования 3D-сцен Blender. CX Codex +1 1 100установок

Из того же набора30

Весь набор →
reference-analysis-validator Скилл reference-analysis-validator измеряет референсы и рендеры Blender и не даёт объявить модель точной копией, пока метрики не сойдутся. CX Codex +1 1 500установок blender-skill-harmonizer Скилл blender-skill-harmonizer для Claude Code задаёт порядок активации, артефакты передачи и правила разрешения конфликтов, когда задача затрагивает несколько Blender-скиллов. CX Codex +1 1 500установок animation-quality-gate Скилл animation-quality-gate проверяет анимации Blender через контактные листы и тесты силуэта перед приёмкой. Помогает вовремя заметить мерцание текстур, срывы морфинга и поломки при экспорте. CX Codex +1 1 500установок atlas-uv-fitting Скилл atlas-uv-fitting для Claude Code находит области текстурных атласов и связывает детали меша с UV-прямоугольниками. Подгоняет текстуры в Blender и готовит GLB. CX Codex +1 1 400установок multiview-fit-loop Скилл multiview-fit-loop закрывает цикл рендер → сравнение → правка → повторный рендер, пока модель не совпадёт с шаблонами вида спереди, сбоку, сзади и сверху. CX Codex +1 1 400установок wireframe-to-3d Скилл wireframe-to-3d для Claude Code и Codex. Превращает PNG-чертежи в ортогональных проекциях в 3D-модель Blender и выгружает её в .glb. Требует фронтальный и боковой вид. CX Codex +1 1 400установок orthographic-registration Скилл orthographic-registration для Claude Code сводит фронтальный, боковой, задний и верхний ортографические виды в одну систему координат Blender. Выравнивает силуэты, если боковой и задний расходятся с фронтальным. CX Codex +1 1 400установок contour-to-mesh Скилл contour-to-mesh для Claude Code строит в Blender триангулированный меш из контура или маски. Силуэт меша совпадает с шаблоном один в один. CX Codex +1 1 400установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой