agent-design SKILL.md skillA

agent-design from nahid-sparktales/agent-dispatcher is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nahid-sparktales/agent-dispatcher/agent-design@git:20260919.a0d4f55

Pins git:20260919.a0d4f55 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nahid-sparktales/agent-dispatcher
Path
skills/ai/agent-design/SKILL.md
Versions recorded
1
Latest version
git:20260919.a0d4f55, committed Sep 19, 2026
Size
6,423 bytes
Repository stars
58
License
MIT

Scope an agent or subagent before it is built — the one job it owns, the smallest tool set that closes that job, what it must never do, and the evidence it has to return. Use when adding an agent, subagent or automated role to a system, when deciding which tools it gets, when an existing agent loops, over-reaches or reports work it did not do, or when reviewing someone else's agent design. Not for wording the prompt itself, not for deciding what occupies its context window, and it never grants…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Agent design

Most agent failures are design failures wearing a prompt's clothing. An agent with two jobs, a
tool it did not need, or no definition of done will fail in ways no amount of rewording fixes.

## When this fires

Before writing an agent's instructions: a new agent or subagent, a new tool granted to an existing
one, or a review of one that misbehaves. It does not fire for a single prompt with no tools and no
loop — that is `prompt-engineering`.

## Procedure

1. **State the job in one sentence with a done condition.** "Finds the failing test and reports
   which commit introduced it" is a job. If the sentence needs an "and", you have two agents, or
   one agent and a chain. Split before designing further.
2. **Draw the boundary in both directions.** What it receives, what it returns, and — named
   explicitly — what it does not do and who does that instead. An agent without a stated
   non-responsibility will grow into whatever is adjacent.
3. **Pick the autonomy level before the tools.** Three honest settings: proposes and stops; acts
   within a reversible sandbox and reports; acts and reports. Anything destructive, outward-facing,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nahid-sparktales/agent-dispatcher/agent-design@sha256:109c7e9cc619f0d8

The line at the top of this page pins the label git:20260919.a0d4f55, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ufju2f7ymo6ifgjf.svg)](https://markdownregistry.com/a/art_ufju2f7ymo6ifgjf)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 19, 2026.

versioncommittedcommitsizeaudit
git:20260919.a0d4f55 latest2026-09-19 a0d4f55 6,423 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6423 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nahid-sparktales/agent-dispatcher · 58 stars · license MIT · pushed 2026-10-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ufju2f7ymo6ifgjf
GET https://markdownregistry.com/api/v1/resolve?ref=nahid-sparktales/agent-dispatcher/agent-design
GET https://markdownregistry.com/api/v1/blob/109c7e9cc619f0d82693d45fee0ebf97b97ef5df02127ea8016af1b7493c3999

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nahid-sparktales/agent-dispatcher

agent-dispatcher SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/agent-dispatcher/SKILL.md · Handle requested Agent Dispatcher work with direct execution or prepared specialist guidance. Includes named roles…
git:20260926.d1b76c1 · audit A · 58 stars
agent-evals SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/agent-evals/SKILL.md · Build an eval suite that can actually detect a regression — cases pulled from real traffic, graders that check…
git:20260919.a0d4f55 · audit A · 58 stars
context-engineering SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/context-engineering/SKILL.md · Decide what actually occupies the model's window — progressive disclosure through an index, retrieval versus inlining…
git:20260919.a0d4f55 · audit A · 58 stars
llm-observability SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/llm-observability/SKILL.md · See what an agent actually did — one trace per run with nested model, tool and retrieval spans, token and latency…
git:20260919.a0d4f55 · audit A · 58 stars
mcp-design SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/mcp-design/SKILL.md · Build an MCP server, or bring an existing one into a project — choosing the transport, deciding which tools, resources…
git:20260919.a0d4f55 · audit A · 58 stars
memory-design SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/memory-design/SKILL.md · Decide what an agent should remember, which layer holds it, who it is scoped to, and how a stale or contradicted memory…
git:20260919.a0d4f55 · audit A · 58 stars
model-routing SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/model-routing/SKILL.md · Pick a model per job and degrade sensibly when one fails — a quality bar per call site, candidates compared on the same…
git:20260919.a0d4f55 · audit A · 58 stars
prompt-engineering SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/prompt-engineering/SKILL.md · Write or revise a prompt so it holds up — output contract, instruction placement, examples that earn their place, an…
git:20260919.a0d4f55 · audit A · 58 stars
prompt-injection-defense SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/prompt-injection-defense/SKILL.md · Treat everything an agent reads but did not author as data rather than instructions — an explicit trust boundary, a…
git:20260919.a0d4f55 · audit A · 58 stars
retrieval-rag SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/retrieval-rag/SKILL.md · Build and fix retrieval that actually returns the right passage — structure-aware chunking, one pinned embedding model…
git:20260919.a0d4f55 · audit A · 58 stars
structured-output SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/structured-output/SKILL.md · Get parseable, trustworthy structured results out of a model — schema design, the enforcement mechanism the provider…
git:20260919.a0d4f55 · audit A · 58 stars
tool-design SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/ai/tool-design/SKILL.md · Design the tools a model calls — names, parameter shapes, what a result returns, and error text written as an…
git:20260919.a0d4f55 · audit A · 58 stars

Every file in nahid-sparktales/agent-dispatcher

Other files named agent-design

agent-design SKILL.md skill
michelkerkmeester/skilled-agent-harness_spec-driven-loops · .hermes/skills/agent-design/SKILL.md · Design specialist across the four sk-design modes: values and behavior, Style Reference measurement, charts and…
git:20261003.4189380 · audit A · 40 stars
agent-design SKILL.md skill
fusengine/agents · plugins/prompt-engineer/skills/agent-design/SKILL.md · Use when choosing between workflow vs agent patterns, structuring orchestrator/subagent pipelines, or writing a Claude…
git:20260729.3b91eed · audit A · 36 stars

Browse by kind, by grade A, or by owner.