excrtx-quality-gepa

Automates skill improvement via closed-loop LLM rewrite and re-judge cycles.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-quality-gepa-elderbernardi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excrtx-quality-gepa
Source: https://github.com/elderbernardi/exocortex.saas/tree/main/skills/excrtx-quality-gepa
Command: npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-quality-gepa-elderbernardi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Skills that fail automated quality evaluation (verdicts of IMPROVE or REWRITE) normally require manual rewriting. This Skill closes the loop between the LLM-as-Judge evaluator and an LLM rewriter, automatically promoting skills to PASS without manual intervention. ## Core Features & Use Cases - Closed-Loop Rewriting: Runs judge → rewrite → re-judge → accept/rollback cycles for each failing skill, with a hard limit of 3 attempts per skill. - Safety Gates: Enforces D1 structural compliance (never regress), bit-for-bit preservation of compiled_rules, and protection of PT-BR calibration fields, with automatic rollback on regression. - Audit Logging: Writes JSON audit logs to .dogfood/runs/gepa/ recording per-skill results, promotions, and D1 regressions. - Use Case: After a skill judge sweep flags excrtx-harness-promptlog with an IMPROVE verdict, run the GEPA loop on that single skill, review the audit log, verify zero D1 regressions, and save a new post-GEPA baseline. ## Quick Start Run the GEPA loop on the skill excrtx-harness-promptlog with a maximum of 2 attempts, then review the generated audit log.

Frequently Asked Questions about excrtx-quality-gepa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically improve a skill that failed the judge evaluation?▼

Run the GEPA loop with `python -m scripts.gepa_loop --skill <name> --max-attempts 2`. It rewrites the skill with an LLM, re-judges it, and accepts or rolls back the change based on the new verdict.

How do I run GEPA on all failing skills at once?▼

Use `python -m scripts.gepa_loop --all --max-attempts 3` for a full batch, or `--rewrite-only` / `--improve-only` to target specific verdicts. Test a single skill first and use `--dry-run` to verify without changes.

What safety gates prevent GEPA from breaking skills?▼

Three gates apply: D1 structural compliance must never regress, the `compiled_rules` frontmatter field must be preserved bit-for-bit, and PT-BR calibration prompts must not be translated or modified. Any violation triggers an immediate rollback.

When should I not use GEPA for skill improvement?▼

Skip GEPA for skills already at PASS, for creating new skills from scratch, for evaluation-only runs (use the skill judge directly), and for non-structural fixes like missing references directories, which require manual work.

Why did a skill fail after multiple GEPA attempts?▼

Each skill is limited to 3 attempts per run; after that it is marked failed and skipped. The minimal strategy on the final attempt may produce only cosmetic changes by design, preferring a clean failure over risky over-modification.