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
In this repository49 other files it gives its agents.
- argument-construction-from-artifactsSkill
- audit-log-of-tool-callsSkill
- bounded-output-designSkill
- capability-negotiation-checkSkill
- changelog-and-versioningSkill
- concurrency-and-ordering-checkSkill
- context-window-managementSkill
- credential-isolationSkill
- data-retention-policySkill
- description-as-contractSkill
- destructive-action-confirmationSkill
- destructive-tool-gatingSkill
- deterministic-command-choicesSkill
- done-when-criteriaSkill
- error-shape-for-agentsSkill
- fixture-driven-transcript-testsSkill
- human-in-the-loop-escalationSkill
- idempotency-annotationSkill
- input-schema-strictnessSkill
- least-privilege-tool-grantsSkill
- lifecycle-test-initialize-then-toolsSkill
- local-vs-remote-boundarySkill
- one-procedure-per-skillSkill
- pagination-and-limit-disciplineSkill
- protocol-conformance-testSkill
- protocol-version-handshakeSkill
- publishing-a-pack-locallySkill
- rate-limit-respectSkill
- reference-canonicalisationSkill
- replay-transcript-for-regressionSkill
- restart-and-reload-semanticsSkill
- scope-guard-before-executionSkill
- search-then-fetch-patternSkill
- secrets-via-environmentSkill
- server-discovery-and-trustSkill
- signal-and-pitfall-sectionsSkill
- skill-frontmatter-contractSkill
- stdio-client-configSkill
- stdout-purity-checkSkill
- third-party-server-sandboxingSkill
- tool-call-budgetingSkill
- tool-call-error-pathsSkill
- tool-error-without-retry-stormSkill
- tools-list-schema-validationSkill
- tool-surface-minimisationSkill
- tool-verb-namingSkill
- transport-choiceSkill
- verify-tool-output-before-reportingSkill
- when-to-use-and-avoidSkill
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
- Distinctive: line 62
every parallel group contains only independent reads
≈ “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
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
- List the calls and mark each as read or write
- Group the reads; leave writes in their own sequential group
- Confirm no read depends on another read's result
- Send the independent reads together
- Order the writes explicitly by their dependency
- 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 once2. Write queue
index rebuild then publish, in order3. Identity keyed
results matched by call id, not positionPitfalls
- 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
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.

