workflow-edit-format
Skill1 starsChanged 6 months agoMITView on GitHub
Make small, well-formed, diff-style edits and verify each one incrementally — the Aider 20%→61% lever.
In this repository33 other files it gives its agents.
- skill-process-gotchasSkill
- workflow-cache-disciplineSkill
- workflow-codegraphSkill
- workflow-conductorSkill
- workflow-context-condenserSkill
- workflow-context-hygieneSkill
- workflow-criticSkill
- workflow-deadline-disciplineSkill
- workflow-deep-researchSkill
- workflow-done-definitionSkill
- workflow-effort-routingSkill
- workflow-escalateSkill
- workflow-execute-from-planSkill
- workflow-filesystem-offloadSkill
- workflow-learn-frameworkSkill
- workflow-long-running-processesSkill
- workflow-lspSkill
- workflow-memory-curationSkill
- workflow-plan-contractSkill
- workflow-plan-firstSkill
- workflow-planSkill
- workflow-quality-barSkill
- workflow-repomapSkill
- workflow-retrieve-before-actSkill
- workflow-spec-drivenSkill
- workflow-stuck-detect-resetSkill
- workflow-stuckSkill
- workflow-subagent-isolationSkill
- workflow-subtask-loopSkill
- workflow-task-finishSkill
- workflow-task-startSkill
- workflow-tool-selectionSkill
- workflow-verify-enhancedSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
One coherent change per edit: Don't bundle unrelated edits — each should be independently correct and reviewable.
- Very specific: line 23
Incremental verify after EACH edit: call mcp_hermes_max_verify_quick_check(path) — fast lint + typecheck, no tests — to confirm the edit is …
- Very specific: line 31
If mcp-verify is down, quick_check is unavailable — fall back to the native file_mutation_verifier
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- TRIGGERS WHEN: Make small, well-formed, diff-style edits and verify each one incrementally — the Aider 20%→61% lever. -->Edit in small, well-formed diffs — and verify each edit before the next.
The single biggest jump in measured edit success (Aider: 20%→61%) came from edit format: targeted search/replace diffs that apply cleanly, not whole-file rewrites that drift. A small model loses the thread on a full-file rewrite; a scoped diff keeps it honest.
Rules
- Prefer diff / search-replace edits over whole-file rewrites. Change the minimum lines needed.
Hermes' native edit tool renders
inline_diffsand runs afile_mutation_verifier— use that native edit path; do NOT paste an entire regenerated file when a few lines change. - One coherent change per edit. Don't bundle unrelated edits — each should be independently correct and reviewable.
- Well-formed: the old text must match exactly (indentation included) and the new text must be syntactically complete (balanced brackets/quotes, valid indentation). A malformed diff that half-applies is worse than no edit.
- Incremental verify after EACH edit: call
mcp_hermes_max_verify_quick_check(path)— fast lint + typecheck, no tests — to confirm the edit is well-formed before moving on. Cheap enough to run every edit. Run the fullmcp_hermes_max_verify_verify(path)(adds the test stage) once at subtask end (workflow-subtask-loop), then checkpoint. - On a
quick_checkfailure: fix THAT edit immediately — do not pile another edit on top of a malformed one. If two fixes don't make it well-formed, revert the edit and rethink.
Graceful degradation
If mcp-verify is down, quick_check is unavailable — fall back to the native file_mutation_verifier
- your own re-read of the changed hunk, and rely on the subtask-end full verify. Keep edits small regardless: small diffs are the protection, the verifier just confirms them.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

