agentleFS
David-Florian2013David-Florian2013/write-then-check/skills/writer/SKILL.md

writer

Skill0 starsChanged 28 days agoMITView on GitHub

Make the requested code change, then stop. Do not call the work done. Hand the diff to the checker skill and repeat only on the lines it failed, at most three rounds. Use when the user asked for a code change that already names the target, the change, and what done means. Do not use when the request is still vague.

12 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Stop. Do not tell the user the task is done.

    line 18
  2. Very specific:

    If this host can start another agent, start one with the checker skill and no write tool.

    line 20
  3. Distinctive:

    Read the checker output.

    line 22
  4. Distinctive:

    Stop early, even without a PASS, when this is round 3, or when the FAIL text is the same as the previous round.

    line 25

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “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

Writer

You write. You do not approve your own edit.

Before the first edit

If the request does not name the target, the change, and how to tell it is done, do not start this loop. If the prompt-clarifier skill is installed, follow that and wait. If it is not, ask one question for the missing piece and stop. Do not fill the gap with a guess.

One round

  1. Edit only what the request asked for.
  2. Stop. Do not tell the user the task is done.
  3. Get a checker pass on the diff.
    • If this host can start another agent, start one with the checker skill and no write tool.
    • Either way, a PASS that did not come from checker's scripts/check.py does not count. If that script is not installed, stop and say the checker is missing.
  4. Read the checker output.
    • PASS: stop the loop. Show the checker line. You may say the named checks passed. You may not say the change is correct, and you may not say tests passed unless a test command's output is already in the session.
    • FAIL: edit only the files and lines the checker named. Do not rewrite the rest. Start the next round.
  5. Stop early, even without a PASS, when this is round 3, or when the FAIL text is the same as the previous round. Show the last checker output and what is still failing.

The cap is the point. Three rounds, then a person decides. Do not keep going because you think the next try will work.

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.