agentleFS
patrickbdevaneypatrickbdevaney/hermes-max/skills/workflow-edit-format/SKILL.md

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.

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
  1. Distinctive:

    One coherent change per edit: Don't bundle unrelated edits — each should be independently correct and reviewable.

    line 18
  2. Very specific:

    Incremental verify after EACH edit: call mcp_hermes_max_verify_quick_check(path) — fast lint + typecheck, no tests — to confirm the edit is …

    line 23
  3. Very specific:

    If mcp-verify is down, quick_check is unavailable — fall back to the native file_mutation_verifier

    line 31

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md
<!-- 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

  1. Prefer diff / search-replace edits over whole-file rewrites. Change the minimum lines needed. Hermes' native edit tool renders inline_diffs and runs a file_mutation_verifier — use that native edit path; do NOT paste an entire regenerated file when a few lines change.
  2. One coherent change per edit. Don't bundle unrelated edits — each should be independently correct and reviewable.
  3. 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.
  4. 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 full mcp_hermes_max_verify_verify(path) (adds the test stage) once at subtask end (workflow-subtask-loop), then checkpoint.
  5. On a quick_check failure: 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.