About

Imported from nickcrew/claude-cortex (skills/evaluator-optimizer/SKILL.md). Install upstream with npx skills add nickcrew/claude-cortex --skill evaluator-optimizer. Copyright stays with the author.

Evaluator-Optimizer

Name: evaluator-optimizer
Author: nickcrew

Iterative refinement workflow that takes existing code, documentation, or designs and polishes them through rigorous cycles of evaluation and improvement until they meet production-grade quality standards.

When to Use This Skill

Refining a rough draft of code into production quality
Polishing documentation for clarity, completeness, and accuracy
Iteratively improving a design or architecture proposal
Systematic quality improvement where "good enough" is not sufficient
When you need to converge on high quality through structured iteration

Quick Reference

Task	Load reference
Evaluation criteria and quality rubrics	`skills/evaluator-optimizer/references/evaluation-criteria.md`

Workflow: The Loop

For any given artifact (code, text, design):

Accept: Take the current version of the artifact.
Evaluate: Act as a harsh critic. Rate the artifact on correctness, clarity, efficiency, style, and safety. Assign a score out of 100.
Decide:
- Score >= 90: Stop and present the result.
- Score < 90: Refine.
Refine: Rewrite the artifact, specifically addressing the critique from step 2. List what changed and why.
Repeat: Return to step 2 with the new version.

Behavioral Rules

Do not settle: "Good enough" is not good enough. You are here to polish.
Be explicit: When evaluating, list specific flaws. "The function process_data is O(n^2) but could be O(n)."
Show your work: Summarize changes in each iteration.
Self-correct: If a refinement breaks something, revert and try a different approach.
Converge: Each iteration must improve the score. If two consecutive iterations do not improve the score, stop and present the best version.

Iteration Output Template

## Iteration [N] Evaluation

| Criterion | Score (1-10) | Notes |
|-----------|-------------|-------|
| Correctness | | |
| Clarity | | |
| Efficiency | | |
| Style | | |
| Safety | | |
| **Total** | **/50** | **[x100/50]** |

### Issues Found
1. [Specific issue with location]
2. [Specific issue with location]

### Refinements Applied
- [Change 1 and rationale]
- [Change 2 and rationale]

Example Interaction

Input: "Refine this Python script."

Iteration 1 Evaluation:

Functionality: Good
Efficiency: Poor - uses nested loops for matching
Style: Variable names a and b are unclear
Score: 60/100

Refinements applied:

Flattened loops using a set lookup (O(n))
Renamed a to users, b to active_ids
Added type hints

Iteration 2 Evaluation:

Functionality: Good
Efficiency: Excellent
Style: Good
Score: 95/100

Result: Present the refined script.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/nickcrew-claude-cortex-evaluator-optimizer/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

nickcrew-claude-cortex-evaluator-optimizer.ocm.jsonjson

{
  "ocm": "1",
  "id": "nickcrew-claude-cortex-evaluator-optimizer",
  "kind": "skill",
  "name": "evaluator-optimizer",
  "description": "Iterative refinement workflow for polishing code, documentation, or designs through systematic evaluation and improvement cycles. Use when refining drafts into production-grade quality.",
  "publisher": "nickcrew",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "refinement",
      "iteration",
      "code-quality",
      "evaluation",
      "optimization",
      "polish",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Iterative refinement workflow for polishing code, documentation, or designs through systematic evaluation and improvement cycles. Use when refining drafts into production-grade quality."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/nickcrew/claude-cortex",
      "path": "skills/evaluator-optimizer/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/nickcrew/claude-cortex/blob/HEAD/skills/evaluator-optimizer/SKILL.md",
      "key": "nickcrew/claude-cortex/skills/evaluator-optimizer/SKILL.md"
    }
  },
  "instructions": "# Evaluator-Optimizer\n\nIterative refinement workflow that takes existing code, documentation, or designs and polishes them through rigorous cycles of evaluation and improvement until they meet production-grade quality standards.\n\n## When to Use This Skill\n\n- Refining a rough draft of code into production quality\n- Polishing documentation for clarity, completeness, and accuracy\n- Iteratively improving a design or architecture proposal\n- Systematic quality improvement where \"good enough\" is not sufficient\n- When you need to converge on high quality through structured iteration\n\n## Quick Referenc",
  "cost": {
    "context_tokens": 685
  }
}

Fetch it by URL: GET /api/v1/registry/nickcrew-claude-cortex-evaluator-optimizer/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.