Pydantic Deep Agents is a self-hosted terminal AI assistant and Python framework for building coding, research, and other AI agents. It gives agents tools such as file access, shell commands, planning, memory, sub-agents, sandboxed execution, and MCP connections, and supports different models.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add vstorm-co/pydantic-deepagents --skill diagram-designgit clone --depth 1 https://github.com/vstorm-co/pydantic-deepagentsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/vstorm-co/pydantic-deepagents/diagram-design)<a href="https://agentmods.dev/skills/vstorm-co/pydantic-deepagents/diagram-design"><img src="https://agentmods.dev/badge/skills/vstorm-co/pydantic-deepagents/diagram-design/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/vstorm-co/pydantic-deepagents/diagram-design"><img src="https://agentmods.dev/badge/skills/vstorm-co/pydantic-deepagents/diagram-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00016 | $0.00940 |
| Opus 5 | $0.00008 | $0.00470 |
| Sonnet 5 | $0.00003 | $0.00188 |
| Haiku 4.5 | $0.00002 | $0.00094 |
Grade A, and why
diagram-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Diagram Design Guide for Research
When to Create Diagrams
Create a diagram when your research findings involve:
- Comparing 3+ options — comparison table or matrix diagram
- Process with 4+ steps — flowchart or sequence diagram
- System with multiple components — architecture diagram
- Chronological events — timeline
- Hierarchical relationships — tree or mind map
- Data flows — data flow diagram
Excalidraw Workflow
- Plan the diagram — decide type, elements, and layout before creating
- Create elements — use
create_elementorbatch_create_elements - Arrange — use
align_elementsanddistribute_elementsfor clean layout - Inspect — use
describe_sceneto verify the diagram looks right - Adjust — use
update_elementto fix positioning or text - Group — use
group_elementsto lock related items together
Note: Do NOT export or share links — the user sees a live embedded canvas that auto-syncs.
Color Palette
Use consistent colors across diagrams:
| Purpose | Color | Hex |
|---|---|---|
| Primary concepts | Blue | #1971c2 |
| Positive / supported | Green | #2f9e44 |
| Negative / limitations | Red | #e03131 |
| Warning / caveats | Orange | #e8590c |
| Neutral / context | Gray | #868e96 |
| Highlight / focus | Yellow | #f08c00 |
Layout Patterns
- Top-to-bottom: Process flows, decision trees, timelines
- Left-to-right: Comparisons, before/after, pipelines
- Radial / center-out: Concept maps, mind maps
- Grid: Feature matrices, comparison tables
Element Guidelines
Text
- Use short labels (2-4 words per element)
- Title font size: 20-24px
- Label font size: 14-16px
- Add detail in sub-labels, not element titles
Shapes
- Rectangles: Processes, components, entities
- Diamonds: Decision points
- Ellipses: Start/end points, concepts
- Rectangles with rounded corners: Groups, categories
Arrows
- Solid arrows: Direct relationships, data flow
- Dashed arrows: Optional paths, indirect relationships
- Label arrows to clarify the relationship
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 113 lines · 16 tokens per session scan A a186b9ed02a8
diagram-design is a skill published in the GitHub repository vstorm-co/pydantic-deepagents (1,061 stars, last pushed 19d ago), licensed MIT. It adds 16 tokens to every session and 940 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
impeccable
Create distinctive, production-grade frontend interfaces with high design quality. Generates creative, polished code that avoids generic AI aesthetics. Use when the user asks to build web components, pages, artifacts, posters, or applications, or when any design skill requires project context. Call with 'craft' for…
ui-architecture
Iris's new UI surface design skill. Takes a brief for a new screen, component, or design system and produces a complete visual architecture spec — component tree, layout grid, interaction states, breakpoints, tokens. No code.
visual-polish
Iris's UI visual polish review skill. Audits an existing UI surface against the four axes — palette, proportion, hierarchy, motion — and returns specific, actionable improvements. No code. Spec output only.
DesignSystemArchitect
Complete design system intelligence — component library design, design tokens, documentation, adoption strategy, governance, versioning, and building a design system that scales with your product.
UserResearchOS
Complete user research intelligence — research planning, interview mastery, usability testing, survey design, Jobs-to-be-Done framework, synthesis, and turning user insights into product decisions.
onboarding-designer
Activates OnboardingDesigner for user and customer onboarding experience design. Use when you need to design a product onboarding flow that minimizes time-to-value, create an in-app onboarding checklist or tour, design a customer onboarding sequence for B2B SaaS, build an email onboarding drip campaign, or analyze…