building-effective-agents SKILL.md skillA

building-effective-agents from michalstrnadel/source-to-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add michalstrnadel/source-to-skill/building-effective-agents@git:20261004.d77ddfa

Pins git:20261004.d77ddfa in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
michalstrnadel/source-to-skill
Path
examples/building-effective-agents/SKILL.md
Versions recorded
1
Latest version
git:20261004.d77ddfa, committed Oct 4, 2026
Size
9,930 bytes
Repository stars
7
License
MIT

Anthropic's guide "Building Effective AI Agents" (Dec 2024) - the workflow vs. agent distinction, the augmented LLM building block, five workflow patterns (prompt chaining, routing, parallelization, orchestrator-workers, evaluator-optimizer), when an autonomous agent is justified, and how to design agent tools (ACI). Load when designing or reviewing an LLM application or agent, choosing between a single call, a workflow and an agent, picking a framework, or writing tool definitions.

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

# Building Effective AI Agents

Source: [Building Effective AI Agents](https://www.anthropic.com/engineering/building-effective-agents)
— Anthropic Engineering, 2024-12-19, by Erik S. and Barry Zhang.
The article itself notes that much of the tooling landscape it describes has
changed since December 2024; the patterns and principles below are what it
teaches, not a survey of current tools.

## Thesis

Across dozens of customer teams, the agent systems that worked best were not
built on complex frameworks but on simple, composable patterns. Start with
the simplest thing that works and add complexity only when it measurably
improves outcomes.

## Vocabulary: workflows vs. agents

Both are "agentic systems"; the split is about who controls the path.

- **Workflow** — LLMs and tools orchestrated through predefined code paths.
  Predictable and consistent; best for well-defined tasks.
- **Agent** — the LLM dynamically directs its own process and tool use and
  decides how to accomplish the task. Flexible; best when model-driven
  decisions are needed at scale.

## Decision ladder: how much system do you need?

Climb only when the rung below demonstrably falls short.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add michalstrnadel/source-to-skill/building-effective-agents@sha256:13b22f1a32ec8034

The line at the top of this page pins the label git:20261004.d77ddfa, 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_eaofgm7bqxjdecvu.svg)](https://markdownregistry.com/a/art_eaofgm7bqxjdecvu)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 4, 2026.

versioncommittedcommitsizeaudit
git:20261004.d77ddfa latest2026-10-04 d77ddfa 9,930 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 (9930 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

michalstrnadel/source-to-skill · 7 stars · license MIT · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eaofgm7bqxjdecvu
GET https://markdownregistry.com/api/v1/resolve?ref=michalstrnadel/source-to-skill/building-effective-agents
GET https://markdownregistry.com/api/v1/blob/13b22f1a32ec80341428def8e94e09d979541ab9793a1b5bbc6183c0ebde93d6

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 michalstrnadel/source-to-skill

attention-is-all-you-need SKILL.md skill
michalstrnadel/source-to-skill · examples/attention-is-all-you-need/SKILL.md · The Transformer paper (Vaswani et al., NIPS 2017, arXiv 1706.03762) distilled - scaled dot-product and multi-head…
git:20261004.d77ddfa · audit A · 7 stars
flask SKILL.md skill
michalstrnadel/source-to-skill · examples/flask/SKILL.md · Working reference for Flask (pallets/flask), the Python WSGI micro web framework built on Werkzeug, Jinja and Click…
git:20261004.d77ddfa · audit A · 7 stars
how-transformers-work SKILL.md skill
michalstrnadel/source-to-skill · examples/how-transformers-work/SKILL.md · How the Transformer and its attention mechanism work, synthesized from the original paper (Vaswani et al., "Attention…
git:20261004.d77ddfa · audit A · 7 stars
intro-to-large-language-models SKILL.md skill
michalstrnadel/source-to-skill · examples/intro-to-large-language-models/SKILL.md · Andrej Karpathy's 1-hour "Intro to Large Language Models" talk (Nov 2023) distilled - what an LLM is (two files -…
git:20261004.d77ddfa · audit A · 7 stars
neural-networks-3blue1brown SKILL.md skill
michalstrnadel/source-to-skill · examples/neural-networks-3blue1brown/SKILL.md · Course skill distilled from 3Blue1Brown's "Neural networks" YouTube playlist (10 videos) - from a plain MNIST digit…
git:20261005.b3e3ebd · audit A · 7 stars
pro-git SKILL.md skill
michalstrnadel/source-to-skill · examples/pro-git/SKILL.md · Git mental models, commands and workflows distilled from Pro Git (2nd ed., Chacon & Straub). Load when explaining how…
git:20261004.d77ddfa · audit A · 7 stars
source-to-skill SKILL.md skill
michalstrnadel/source-to-skill · skills/source-to-skill/SKILL.md · Turn a YouTube video, playlist or channel, podcast or audio/video file (local Whisper), academic paper (PDF / arXiv…
git:20261005.49397ad · audit A · 7 stars

Every file in michalstrnadel/source-to-skill

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