claude-agent-sdk SKILL.md skillA
claude-agent-sdk from tdimino/claude-code-minoan is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add tdimino/claude-code-minoan/claude-agent-sdk@git:20260421.4ffae7aPins git:20260421.4ffae7a in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- tdimino/claude-code-minoan
- Path
skills/core-development/claude-agent-sdk/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260421.4ffae7a, committed Apr 21, 2026
- First version recorded
- Jan 21, 2026
- Size
- 8,527 bytes
- Repository stars
- 41
- License
- MIT
Build AI agents using the Claude Agent SDK. Covers query functions,.
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
<essential_principles>
## Claude Agent SDK Overview
The Claude Agent SDK gives agents the same tools that power Claude Code:
file operations, bash commands, web search, and more. Build autonomous agents
that read files, run commands, search the web, edit code, and verify their work.
### Two Ways to Query
| Function | Session | Best For |
|----------|---------|----------|
| `query()` | New each time | One-off tasks, automation |
| `ClaudeSDKClient` | Continuous | Conversations, follow-ups, hooks |
**Key Difference:** `query()` is simpler but doesn't support hooks, interrupts, or
custom tools. Use `ClaudeSDKClient` for advanced features.
### Agent Loop Pattern
Agents operate in a feedback loop:
```
gather context → take action → verify work → repeat
```
### Installation
**Python:**
```bash
uv add claude-agent-sdk
```
**TypeScript:**
```bash
npm install @anthropic-ai/claude-agent-sdk
```
**Requirements:**
- Claude Code CLI installed (`npm install -g @anthropic-ai/claude-code`)
- `ANTHROPIC_API_KEY` environment variable set
### Quick Start
```python
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
…Read the whole file at its exact version.
How to install
mdr add tdimino/claude-code-minoan/claude-agent-sdk@sha256:c6c31821ad8e05c6The line at the top of this page pins the label git:20260421.4ffae7a, 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.
[](https://markdownregistry.com/a/art_ohjmaoee2siovwpm)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Jan 21, 2026 and Apr 21, 2026, about one every 30 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260421.4ffae7a latest | 2026-04-21 | 4ffae7a | 8,527 B | A | view · diff |
| git:20260218.7500105 | 2026-02-18 | 7500105 | 7,628 B | A | view · diff |
| git:20260215.1410757 | 2026-02-15 | 1410757 | 6,753 B | A | view · diff |
| git:20260121.3a8e21e | 2026-01-21 | 3a8e21e | 6,759 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8527 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
tdimino/claude-code-minoan · 41 stars · license MIT · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ohjmaoee2siovwpm GET https://markdownregistry.com/api/v1/resolve?ref=tdimino/claude-code-minoan/claude-agent-sdk GET https://markdownregistry.com/api/v1/blob/c6c31821ad8e05c66ee15c8e3ad89491ed59387b4a1c5e3e55b8e2fa27351962
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 tdimino/claude-code-minoan
Every file in tdimino/claude-code-minoan