agentleFS
Wsh7AshWsh7Ash/skillmcp/skills/parallel-tool-call-safety/SKILL.md

parallel-tool-call-safety

Skill0 starsChanged 15 days agoMITView on GitHub

Only parallelise calls that are independent, and never parallelise anything that writes. Use when several lookups are needed and latency matters

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 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.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    every parallel group contains only independent reads

    line 62

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

Parallel Tool Call Safety

Only parallelise calls that are independent, and never parallelise anything that writes

Use when: several lookups are needed and latency matters

Avoid when: calls depend on each other's output, which makes parallelism meaningless

Procedure

  1. List the calls and mark each as read or write
  2. Group the reads; leave writes in their own sequential group
  3. Confirm no read depends on another read's result
  4. Send the independent reads together
  5. Order the writes explicitly by their dependency
  6. Reconcile results by call identity, never by arrival order

Signals

  • independent reads complete in one round of latency
  • writes are serialised and ordered
  • each result is attributed to the exact call that produced it
  • a failed read does not cancel the others silently

Patterns

1. Read batch

three searches with different keywords at once

2. Write queue

index rebuild then publish, in order

3. Identity keyed

results matched by call id, not position

Pitfalls

  • Parallelising two writes that touch the same file
  • Assuming response order matches request order
  • Cancelling a batch because one call errored, losing the successful results

Done when

  • every parallel group contains only independent reads
  • results are attributed by call identity

References

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.