Voltagent Best Practices

VoltAgent architectural patterns and conventions. Covers agents vs workflows, project layout, memory, servers, and observability.

16 stars 10 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add VoltAgent/skills --skill voltagent-best-practices

Manual install

git clone --depth 1 https://github.com/VoltAgent/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/voltagent-best-practices ~/.claude/skills/voltagent-best-practices

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# VoltAgent Best Practices

Quick reference for VoltAgent conventions and patterns.

---

## Choosing Agent or Workflow

| Use | When |
| --- | --- |
| Agent | Open-ended tasks that require tool selection and adaptive reasoning |
| Workflow | Multi-step pipelines with explicit control flow and suspend/resume |

---

## Layout

```
src/
|-- index.ts
|-- agents/
|-- tools/
`-- workflows/
```

---

## Quick Snippets

### Basic Agent

```typescript
import { Agent } from "@voltagent/core";

const agent = new Agent({
  name: "assistant",
  instructions: "You are helpful.",
  model: "openai/gpt-4o-mini",
});
```

Model format is `provider/model` (for example `openai/gpt-4o-mini` or `anthropic/claude-3-5-sonnet`).

### Basic Workflow

```typescript
import { createWorkflowChain } from "@voltagent/core";
import { z } from "zod";

const workflow = createWorkflowChain({
  id: "example",
  input: z.object({ text: z.string() }),
  result: z.object({ summary: z.string() }),
}).andThen({
  id: "summarize",
  execute: async ({ data }) => ({ summary: data.text }),
});
```

### VoltAgent Bootstrap

```typescript
import { VoltAgent } from "@voltagent/core";
import { honoServer } from "@voltagent/server-hono";

new VoltAgent({
  agents: { agent },
  workflows: { workflow },
  server: honoServer(),
});
```

---

## Memory Defaults

- Use `memory` for a shared default across agents and workflows.
- Use `agentMemory` or `workflowMemory` when defaults need to differ.

---

## Server Options

Read the full skill on GitHub

Details

Skill name: voltagent-best-practices
Repository: VoltAgent/skills
Path: skills/voltagent-best-practices/SKILL.md
License: MIT
Repo updated: 27 January 2026
Listed in: heilcheng/awesome-agent-skills

FAQ

What does the Voltagent Best Practices skill do?

VoltAgent architectural patterns and conventions. Covers agents vs workflows, project layout, memory, servers, and observability.

How do I install the Voltagent Best Practices skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add VoltAgent/skills --skill voltagent-best-practices. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Voltagent Best Practices popular?

It lives in VoltAgent/skills, which has 16 GitHub stars and 10 forks, and is included in 1 curated skill list.

Related skills

Create Voltagent

VoltAgent/skills

Skill for creating AI agent projects using the VoltAgent framework. Guide for CLI setup and manual bootstrapping.

AI, LLMs & AgentsIn 1 list10

Voltagent Core Reference

VoltAgent/skills

Reference for the VoltAgent class: constructor options, lifecycle methods, and runtime behavior.

OtherIn 1 list10

Voltagent Docs Bundle

VoltAgent/skills

Look up VoltAgent documentation embedded in node_modules/@voltagent/core/docs for version-matched docs. Use for API signatures, guides, and examples.

Writing & ContentIn 1 list10

Research Note Wrap

leonsong09/research-note-wrap

Use when the user wants to summarize research or analysis into a readable Obsidian markdown note, such as 总结调研, 输出结论, 总结分析, 输出笔记, 调研纪要, 分析纪要, 会话结论, or when asking to summarize today's sessions about a topic. Use for current-session summaries by default, and for cross-session topic summaries when the user mentions 今天会话 or gives a topic scope.

Productivity & Notes

Google Calendar

ShaunTsai/skill-google-calendar

Full Google Calendar integration via gcalcli. Read, create, edit, delete, and search calendar events. Use when the user asks about their schedule, upcoming events, availability, meetings, or wants to manage their calendar. Triggers on keywords like calendar, schedule, meeting, event, free time, availability, agenda, add event, delete event, reschedule.

Productivity & Notes

Process Builder

Castaldo-Solutions/process-builder

Crea swimlane diagram professionali e leggibili come file draw.io (.drawio), usando notazione ibrida BPMN con palette curata. Gestisce due modalita: AS-IS (documenta il processo attuale con pain point, attori, strumenti) e TO-BE (propone automazioni con roadmap a 2 versioni: Quick Win e Full Automation). Usa questa skill ogni volta che l'utente vuole: mappare un processo aziendale, fare un'analisi AS-IS di un flusso di lavoro, proporre automazioni o miglioramenti a un processo esistente, creare una roadmap di trasformazione digitale, disegnare un diagramma di processo con swimlane, analizzare

Productivity & NotesIn 1 list

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.