iterative-refinement SKILL.md skillA

iterative-refinement from corvinlabs/corvinos is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add corvinlabs/corvinos/iterative-refinement@git:20260915.459047e

Pins git:20260915.459047e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
corvinlabs/corvinos
Path
corvin_operator/bundle/skills/ldd/iterative-refinement/SKILL.md
Versions recorded
1
Latest version
git:20260915.459047e, committed Sep 15, 2026
Size
8,478 bytes
Repository stars
24
License
Apache-2.0

Use when a deliverable (document, diff, design, report, code module) is complete but "good enough, not great" and you want to improve it with a targeted re-iteration instead of starting over. Forbids re-running the task from scratch when refinement is more efficient. Operates on the y-axis (output) not the θ-axis (code or method).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Iterative-Refinement

## Overview

Most agents, when told "this is okay but can be better," do one of two wrong things:

1. **Re-run the task from scratch.** Wastes budget, loses whatever was good in the first attempt, gambles on random variation.
2. **Polish by gut feel.** No loss signal, no gradient, no stopping criterion. Converges to the agent's aesthetic prior, not to a better deliverable.

**Core principle:** refinement is a *second* gradient-descent pass, on the **y-axis** (the deliverable itself), using a **specific gradient** derived from the previous output's defects. The inputs, the task, the code, the skills — all held fixed. Only the deliverable changes.

This is the skill-level equivalent of `awp refine` (AWP's normative refinement mode). See [`../../docs/ldd/convergence.md`](../../docs/ldd/convergence.md) §1 for the three-loop model.

## When to Use

Invoke when **all** of:

- A deliverable (document, code module, design artifact, plan) is **complete** (not partial, not stuck)
- The deliverable is **usable but imperfect** — passes the minimum bar, fails the bar you actually want
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add corvinlabs/corvinos/iterative-refinement@sha256:b2b72754b1e7b433

The line at the top of this page pins the label git:20260915.459047e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_segxwm4wjlnt3xfp.svg)](https://markdownregistry.com/a/art_segxwm4wjlnt3xfp)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 15, 2026.

versioncommittedcommitsizeaudit
git:20260915.459047e latest2026-09-15 459047e 8,478 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8478 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

corvinlabs/corvinos · 24 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_segxwm4wjlnt3xfp
GET https://markdownregistry.com/api/v1/resolve?ref=corvinlabs/corvinos/iterative-refinement
GET https://markdownregistry.com/api/v1/blob/b2b72754b1e7b433c1aa4188309678dd724fa8630bdad23ed672dce9366da7bd

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from corvinlabs/corvinos

CLAUDE.md CLAUDE.md file
corvinlabs/corvinos · CLAUDE.md
git:20261105.74f2594 · audit B · 24 stars
market_analyst SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/dag_complex/src/skills/market_analyst/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
news_analyst SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/dag_simple/src/skills/news_analyst/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
code_reviewer SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/delegation/src/skills/code_reviewer/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
data_analysis SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/data_analysis/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
quality_assessment SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/quality_assessment/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
report_writing SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/full_pipeline/src/skills/report_writing/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
quant_trading SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/mixed/src/skills/quant_trading/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
risk_management SKILL.md skill
corvinlabs/corvinos · core/awpkg/tests/fixtures/mixed/src/skills/risk_management/SKILL.md
git:20260831.ba2b871 · audit C · 24 stars
os.delegation_router SKILL.md skill
corvinlabs/corvinos · core/skills/bundled/os_delegation_router_v1.0/SKILL.md · Route tasks to native OS, ACS, or TDE
v1.0.0 · audit A · 24 stars
adr_gate SKILL.md skill
corvinlabs/corvinos · corvin_operator/bundle/skills/ldd/adr_gate/SKILL.md · ADR Gate — evaluates after non-trivial tasks whether an ADR is warranted; creates it in the tenant knowledge base…
git:20261103.0105fa8 · audit A · 24 stars
concept_gate SKILL.md skill
corvinlabs/corvinos · corvin_operator/bundle/skills/ldd/concept_gate/SKILL.md · Concept Gate — evaluates after non-trivial tasks whether a reusable WORKING METHOD (not a decision, not a bug fix) is…
git:20261103.0105fa8 · audit A · 24 stars

Every file in corvinlabs/corvinos

Browse by kind, by grade A, or by owner.