[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6E6VAFNRFAC8TN25PPQN04H":3,"skill-same:01M6E6VAFNRFAC8TN25PPQN04H":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":30,"linkOnly":31,"markdownContent":32,"markdownBody":33,"frontMatter":34,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":43,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M6E6VAFNRFAC8TN25PPQN04H","voltagent-best-practices",null,"VoltAgent architectural patterns and conventions. Covers agents vs workflows, project layout, memory, servers, and observability.","luokai0\u002Fai-agent-skills-by-luo-kai","luokai0","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F266954973?v=4","01M6E16VNT42JB8B3X3254QWJ7","luo kai","01M6E16VTFVP6S5XJF1V1MPV90",14,"MIT","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F18-ai-agents-and-automation (by Luo Kai)\u002F01-agent-frameworks\u002Fvoltagent-best-practices\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29],"best practices","voltagent best practices","github","memory","workflows","observability","https","patterns","conventions","project","layout","2026-11-10 10:12:30",false,"---\nauthor: luo-kai\nname: voltagent-best-practices\n# prettier-ignore\ndescription: VoltAgent architectural patterns and conventions. Covers agents vs workflows, project layout, memory, servers, and observability.\nlicense: MIT\nmetadata:\n  author: VoltAgent\n  version: \"1.0.0\"\n  repository: https:\u002F\u002Fgithub.com\u002FVoltAgent\u002Fskills\n---\n\n# VoltAgent Best Practices\n\nQuick reference for VoltAgent conventions and patterns.\n\n---\n\n## Choosing Agent or Workflow\n\n| Use | When |\n| --- | --- |\n| Agent | Open-ended tasks that require tool selection and adaptive reasoning |\n| Workflow | Multi-step pipelines with explicit control flow and suspend\u002Fresume |\n\n---\n\n## Layout\n\n```\nsrc\u002F\n|-- index.ts\n|-- agents\u002F\n|-- tools\u002F\n`-- workflows\u002F\n```\n\n---\n\n## Quick Snippets\n\n### Basic Agent\n\n```typescript\nimport { Agent } from \"@voltagent\u002Fcore\";\n\nconst agent = new Agent({\n  name: \"assistant\",\n  instructions: \"You are helpful.\",\n  model: \"openai\u002Fgpt-4o-mini\",\n});\n```\n\nModel format is `provider\u002Fmodel` (for example `openai\u002Fgpt-4o-mini` or `anthropic\u002Fclaude-3-5-sonnet`).\n\n### Basic Workflow\n\n```typescript\nimport { createWorkflowChain } from \"@voltagent\u002Fcore\";\nimport { z } from \"zod\";\n\nconst workflow = createWorkflowChain({\n  id: \"example\",\n  input: z.object({ text: z.string() }),\n  result: z.object({ summary: z.string() }),\n}).andThen({\n  id: \"summarize\",\n  execute: async ({ data }) => ({ summary: data.text }),\n});\n```\n\n### VoltAgent Bootstrap\n\n```typescript\nimport { VoltAgent } from \"@voltagent\u002Fcore\";\nimport { honoServer } from \"@voltagent\u002Fserver-hono\";\n\nnew VoltAgent({\n  agents: { agent },\n  workflows: { workflow },\n  server: honoServer(),\n});\n```\n\n---\n\n## Memory Defaults\n\n- Use `memory` for a shared default across agents and workflows.\n- Use `agentMemory` or `workflowMemory` when defaults need to differ.\n\n---\n\n## Server Options\n\n- Use `@voltagent\u002Fserver-hono` for Node HTTP servers.\n- Use `@voltagent\u002Fserver-elysia` as an alternative Node server provider.\n- Use `serverless` provider for fetch runtimes (Cloudflare, Netlify).\n\n---\n\n## Observability Notes\n\n- Use `VoltOpsClient` or `createVoltAgentObservability` for tracing.\n- VoltAgent will auto-configure VoltOps if `VOLTAGENT_PUBLIC_KEY` and `VOLTAGENT_SECRET_KEY` are set.\n\n---\n\n## Recipes\n\nShort best-practice recipes live in the embedded docs:\n\n- `packages\u002Fcore\u002Fdocs\u002Frecipes\u002F`\n- Search: `rg -n \"keyword\" packages\u002Fcore\u002Fdocs\u002Frecipes -g\"*.md\"`\n- Read: `cat packages\u002Fcore\u002Fdocs\u002Frecipes\u002F\u003Cfile>.md`\n\n---\n\n## Footguns\n\n- Do not use `JSON.stringify` inside VoltAgent packages. Use `safeStringify` from `@voltagent\u002Finternal`.\n\n---\n\n## Resources\n\n- https:\u002F\u002Fvoltagent.dev\u002Fdocs\n- https:\u002F\u002Fgithub.com\u002Fvoltagent\u002Fvoltagent\n- https:\u002F\u002Fgithub.com\u002Fvoltagent\u002Fvoltagent\u002Ftree\u002Fmain\u002Fexamples\n","# VoltAgent Best Practices\n\nQuick reference for VoltAgent conventions and patterns.\n\n---\n\n## Choosing Agent or Workflow\n\n| Use | When |\n| --- | --- |\n| Agent | Open-ended tasks that require tool selection and adaptive reasoning |\n| Workflow | Multi-step pipelines with explicit control flow and suspend\u002Fresume |\n\n---\n\n## Layout\n\n```\nsrc\u002F\n|-- index.ts\n|-- agents\u002F\n|-- tools\u002F\n`-- workflows\u002F\n```\n\n---\n\n## Quick Snippets\n\n### Basic Agent\n\n```typescript\nimport { Agent } from \"@voltagent\u002Fcore\";\n\nconst agent = new Agent({\n  name: \"assistant\",\n  instructions: \"You are helpful.\",\n  model: \"openai\u002Fgpt-4o-mini\",\n});\n```\n\nModel format is `provider\u002Fmodel` (for example `openai\u002Fgpt-4o-mini` or `anthropic\u002Fclaude-3-5-sonnet`).\n\n### Basic Workflow\n\n```typescript\nimport { createWorkflowChain } from \"@voltagent\u002Fcore\";\nimport { z } from \"zod\";\n\nconst workflow = createWorkflowChain({\n  id: \"example\",\n  input: z.object({ text: z.string() }),\n  result: z.object({ summary: z.string() }),\n}).andThen({\n  id: \"summarize\",\n  execute: async ({ data }) => ({ summary: data.text }),\n});\n```\n\n### VoltAgent Bootstrap\n\n```typescript\nimport { VoltAgent } from \"@voltagent\u002Fcore\";\nimport { honoServer } from \"@voltagent\u002Fserver-hono\";\n\nnew VoltAgent({\n  agents: { agent },\n  workflows: { workflow },\n  server: honoServer(),\n});\n```\n\n---\n\n## Memory Defaults\n\n- Use `memory` for a shared default across agents and workflows.\n- Use `agentMemory` or `workflowMemory` when defaults need to differ.\n\n---\n\n## Server Options\n\n- Use `@voltagent\u002Fserver-hono` for Node HTTP servers.\n- Use `@voltagent\u002Fserver-elysia` as an alternative Node server provider.\n- Use `serverless` provider for fetch runtimes (Cloudflare, Netlify).\n\n---\n\n## Observability Notes\n\n- Use `VoltOpsClient` or `createVoltAgentObservability` for tracing.\n- VoltAgent will auto-configure VoltOps if `VOLTAGENT_PUBLIC_KEY` and `VOLTAGENT_SECRET_KEY` are set.\n\n---\n\n## Recipes\n\nShort best-practice recipes live in the embedded docs:\n\n- `packages\u002Fcore\u002Fdocs\u002Frecipes\u002F`\n- Search: `rg -n \"keyword\" packages\u002Fcore\u002Fdocs\u002Frecipes -g\"*.md\"`\n- Read: `cat packages\u002Fcore\u002Fdocs\u002Frecipes\u002F\u003Cfile>.md`\n\n---\n\n## Footguns\n\n- Do not use `JSON.stringify` inside VoltAgent packages. Use `safeStringify` from `@voltagent\u002Finternal`.\n\n---\n\n## Resources\n\n- https:\u002F\u002Fvoltagent.dev\u002Fdocs\n- https:\u002F\u002Fgithub.com\u002Fvoltagent\u002Fvoltagent\n- https:\u002F\u002Fgithub.com\u002Fvoltagent\u002Fvoltagent\u002Ftree\u002Fmain\u002Fexamples\n",{"name":5,"author":35,"license":15,"metadata":36,"description":7},"luo-kai",{"author":37,"version":38,"repository":39},"VoltAgent","1.0.0","https:\u002F\u002Fgithub.com\u002FVoltAgent\u002Fskills","main","4d2fb89cdfb75f3f6fd3c6c5ec9ad90ea129eb3c","ai-agent-skills\u002F18-ai-agents-and-automation (by Luo Kai)\u002F01-agent-frameworks\u002Fvoltagent-best-practices",1,"https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai","https:\u002F\u002Fgithub.com\u002Fluokai0","a solo builder.","2026-05-06 04:29:04",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add luokai0\u002Fai-agent-skills-by-luo-kai --skill voltagent-best-practices",{"tool":54,"command":55},"bunx","bunx skills add luokai0\u002Fai-agent-skills-by-luo-kai --skill voltagent-best-practices",{"tool":57,"command":58},"pnpm","pnpm dlx skills add luokai0\u002Fai-agent-skills-by-luo-kai --skill voltagent-best-practices","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F18-ai-agents-and-automation (by Luo Kai)\u002F01-agent-frameworks\u002Fvoltagent-best-practices\u002FSKILL.md",true,[62],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"customize.toml","OTHER","其他",3357,"https:\u002F\u002Fgithub.com\u002Fmugsun\u002Fcurdx-flow\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fbmad-agent-analyst\u002Fcustomize.toml",[69,96,113,142,173,210],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":30},"01M6F2SKTE208174C7S7JJCZC7","write-contracts","Generates secure Aptos Move V2 smart contracts with Object model, Digital Asset integration, security patterns, and storage type guidance. Includes comprehensive storage decision framework for optimal data structure selection. Triggers on: 'write contract', 'create NFT collection', 'build marketplace', 'implement minting', 'generate Move module', 'create token contract', 'build DAO', 'implement staking'. Ask storage questions when: 'store', 'track', 'registry', 'mapping', 'list', 'collection'.","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Fwrite-contracts\u002FSKILL.md",[],[76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95],"write","contracts","write contracts","storage","secure","create","generate","collection","model","decision","ask","smart-contracts","selection","objects","structure","nft","token","aptos","critical","move",{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":30},"01M6F2RFXJ6T9MKW0A7N7GM45B","web-search","通用网络搜索技能，支持多引擎搜索（百度、必应、DuckDuckGo），无需API密钥即可获取实时信息","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Fweb-search-ex-skill\u002FSKILL.md",[],[103,104,105,106,107,108,109,110,111,112],"web","search","web search","搜索","baidu","bing","duckduckgo","百度","多引擎","internet",{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":124,"publishedAt":30},"01M6F2K968G1FZEZFPW2E6B222","solo-build","Execute implementation plan tasks with TDD workflow, auto-commit, and phase gates. Use when user says \"build it\", \"start building\", \"execute plan\", \"implement tasks\", \"ship it\", or references a track ID. Do NOT use for planning (use \u002Fplan) or scaffolding (use \u002Fscaffold).","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Fsolo-build\u002FSKILL.md",[119],{"categoryNo":120,"categoryName":121,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[125,126,127,128,129,130,131,132,104,133,134,135,76,136,137,138,139,140,141,28],"build","solo","solo build","MCP","workflow","commit","tasks","code","Bash","plan","read","auto","references","context7","query","scaffolding","ship it",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":154,"publishedAt":30},"01M6F2GKN39SGHSPWYB3662YC8","react-email","Use when building HTML email templates with React components, adding a visual email editor to an application using the React Email visual editor, rendering emails to HTML, or sending emails with Resend. Covers welcome emails, password resets, notifications, order confirmations, newsletters, transactional emails, and the embeddable email editor component.","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Freact-email-skills\u002FSKILL.md",[148,151],{"categoryNo":149,"categoryName":150,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000005","邮件与沟通",{"categoryNo":152,"categoryName":153,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000009","前端开发",[155,156,157,21,158,159,160,161,162,25,163,164,165,166,167,168,169,170,171,172],"react","email","react email","editor","components","react components","component","welcome","notifications","password","node","use","html","resend","visual","emails","rendering","with",{"skillNo":174,"name":175,"nameZh":6,"description":176,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":177,"categories":178,"keywords":191,"publishedAt":30},"01M6F2FBVGVDFSG8SSFJGXA40C","APITester Agent-Driven API Testing","Test API endpoints and document responses. Define tests in plain English, run them, get formatted results. Agent-driven Postman alternative.","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Fopenclaw-api-tester\u002FSKILL.md",[179,182,185,186],{"categoryNo":180,"categoryName":181,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":183,"categoryName":184,"taxonomyType":122,"taxonomyTypeDesc":123},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":120,"categoryName":121,"taxonomyType":122,"taxonomyTypeDesc":123},{"categoryNo":187,"categoryName":188,"taxonomyType":189,"taxonomyTypeDesc":190},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209],"testing","api","api testing","driven","APITester Agent Driven API Testing","test","run","postman","results","plain english","tester","endpoints","document","get","define","tests","english","api-tester",{"skillNo":211,"name":212,"nameZh":6,"description":213,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":214,"categories":215,"keywords":216,"publishedAt":30},"01M6F273Y3NGAPVJZ608BC0G9G","hubspot-implementation-plan","Generate a phased implementation plan from a HubSpot audit report. Creates prioritized, sequenced cleanup processes with effort estimates, dependencies, and automation feasibility. Use after running \u002Fhubspot-audit.","https:\u002F\u002Fgithub.com\u002Fluokai0\u002Fai-agent-skills-by-luo-kai\u002Fblob\u002Fmain\u002Fai-agent-skills\u002F22-clawhub-skills\u002Fhubspot-implementation-plan\u002FSKILL.md",[],[134,217,218,219,220,221,222,82,223,224,225,226,227,166,228,229,172,230],"implementation","hubspot","hubspot implementation plan","automation","feasibility","cleanup","planning","report","audit","audit report","phased implementation","dependencies","processes","hubspot audit"]