Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.
The @vibesjs/sdk agent skill gives your coding assistant (Claude Code or any compatible agent) complete, up-to-date knowledge of the framework API - tools, agents, toolsets, dependency injection, structured output, streaming, testing, graph workflows, evals, MCP, and more.Once installed, your agent writes idiomatic @vibesjs/sdk code without needing to look up documentation.
Project-level installs the skill only for this project. Global makes it available across all your projects. Project-level is recommended so the skill version stays in sync with your @vibesjs/sdk version.
The port-pydantic-ai-community-plugins skill guides you through porting any Python pydantic-ai community plugin to a TypeScript @vibesjs/sdk community toolset.
The skill is versioned alongside the framework. When you upgrade @vibesjs/sdk, re-run the install command to pull the latest skill.
# Re-run the same install command to updatecurl -fsSL https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/vibes-sdk.md -o .claude/agents/vibes-sdk.md
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vibes Agent SDK","description":"Pydantic AI patterns for TypeScript. Using Vercel AI SDK.","colors":{"primary":"#18181B","light":"#FFFFFF","dark":"#09090B"},"logo":{"light":"https://mintcdn.com/personal-b3af1c31/qvI9_ro7L0JRXWH9/logo/light.svg?fit=max\u0026auto=format\u0026n=qvI9_ro7L0JRXWH9\u0026q=85\u0026s=3810b9d4cf0db80f00425a70d0459b2e","dark":"https://mintcdn.com/personal-b3af1c31/qvI9_ro7L0JRXWH9/logo/dark.svg?fit=max\u0026auto=format\u0026n=qvI9_ro7L0JRXWH9\u0026q=85\u0026s=7f30dfaf9fa6a9820cff667dc879333c"},"favicon":"/favicon.svg","navbar":{"links":[{"href":"https://jsr.io/@vibesjs/sdk","label":"JSR"}],"primary":{"type":"button","label":"⭐ Star on GitHub","href":"https://github.com/a7ul/vibes"}},"search":{"prompt":"How can I help you build AI agents?"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"personal-b3af1c31","hasAudioNarration":false,"actualSubdomain":"personal-b3af1c31","customDomains":["vibes-sdk.a7ul.com"],"gitSource":{"type":"github","owner":"a7ul","repo":"vibes","deployBranch":"main","contentDirectory":"packages/sdk/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21db854aebf57141de88e4","collectionId":"cf6f0985-9066-41a6-811d-80392f843f37","schemaVersion":"v2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae94a1ed69537c8ab71a184:success","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"Concepts","count":19},{"language":"default","tag":"Examples","count":9},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Integrations","count":6},{"language":"default","tag":"Community","count":5},{"language":"default","tag":"Meta","count":5},{"language":"default","tag":"Advanced","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geist/v5/gyByhwUxId8gMEwRGFWfOw.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geist/v5/gyByhwUxId8gMEwYGFWfOw.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geist/v5/gyByhwUxId8gMEwTGFWfOw.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geist/v5/gyByhwUxId8gMEwSGFWfOw.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist';\n font-style: normal;\n font-weight: 100 900;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geist/v5/gyByhwUxId8gMEwcGFU.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\nbody,html{font-family:'Geist', sans-serif!important}html:not(.dark) body,html:not(.dark) #__mintlify,html:not(.dark) main{background-color:#FAF8F4!important}a[data-active=\"true\"],[aria-current=\"page\"],[data-state=\"active\"]{background-color:rgba(0, 0, 0, 0.06)!important;color:#18181B!important}.dark a[data-active=\"true\"],.dark [aria-current=\"page\"],.dark [data-state=\"active\"]{background-color:rgba(255, 255, 255, 0.08)!important;color:#FFFFFF!important}"}],"page":{"pagePath":"meta/agent-skill","slug":"/meta/agent-skill","pageMetadata":{"title":"Agent Skill","description":"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.","href":"/meta/agent-skill","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`@vibesjs/sdk`}),` agent skill gives your coding assistant (Claude Code or any compatible agent) complete, up-to-date knowledge of the framework API - tools, agents, toolsets, dependency injection, structured output, streaming, testing, graph workflows, evals, MCP, and more.`]}),`\n`,_jsxs(_components.p,{children:[`Once installed, your agent writes idiomatic `,_jsx(_components.code,{children:`@vibesjs/sdk`}),` code without needing to look up documentation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`install`,children:`Install`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Project-level (recommended)`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .claude/agents`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/vibes-sdk.md`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .claude/agents/vibes-sdk.md`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Global (all projects)`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.claude/agents`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/vibes-sdk.md`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.claude/agents/vibes-sdk.md`})]}),`\n`]})})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Project-level`}),` installs the skill only for this project. `,_jsx(_components.strong,{children:`Global`}),` makes it available across all your projects. Project-level is recommended so the skill version stays in sync with your `,_jsx(_components.code,{children:`@vibesjs/sdk`}),` version.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`manual-install`,children:`Manual install`}),`\n`,_jsxs(_components.p,{children:[`If you prefer not to use `,_jsx(_components.code,{children:`curl`}),`, copy `,_jsx(_components.code,{children:`vibes-sdk.md`}),` from the `,_jsx(_components.a,{href:`https://github.com/a7ul/vibes/tree/main/packages/sdk/skills`,children:_jsx(_components.code,{children:`skills/`})}),` directory of this repo to:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Project-level`}),`: `,_jsx(_components.code,{children:`.claude/agents/vibes-sdk.md`}),` in your project root`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Global`}),`: `,_jsx(_components.code,{children:`~/.claude/agents/vibes-sdk.md`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(_components.p,{children:`After installing, reference the skill explicitly:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use the vibes-sdk skill to help me build an agent that...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Or just start working - Claude Code picks it up automatically when it detects `,_jsx(_components.code,{children:`@vibesjs/sdk`}),` in your project.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it works`}),`\n`,_jsxs(_components.p,{children:[`The skill does `,_jsx(_components.strong,{children:`not`}),` embed a static copy of the API. Instead it instructs the agent to:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Fetch live docs via `,_jsx(_components.a,{href:`https://context7.com`,children:`Context7`})]}),` (if available) - always reflects the latest published version`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Fall back to fetching docs directly from GitHub`}),` via `,_jsx(_components.code,{children:`WebFetch`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Apply a small set of static “gotchas”`}),` - non-obvious patterns that are easy to get wrong regardless of framework version`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This means the skill stays accurate as the framework evolves - no manual updates needed.`}),`\n`,_jsx(Heading,{level:`2`,id:`porting-pydantic-ai-plugins`,children:`Porting pydantic-ai plugins`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`port-pydantic-ai-community-plugins`}),` skill guides you through porting any Python pydantic-ai community plugin to a TypeScript `,_jsx(_components.code,{children:`@vibesjs/sdk`}),` community toolset.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Project-level (recommended)`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .claude/agents`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/port-pydantic-ai-community-plugins.md`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .claude/agents/port-pydantic-ai-community-plugins.md`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Global (all projects)`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`mkdir`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.claude/agents`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/port-pydantic-ai-community-plugins.md`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ~/.claude/agents/port-pydantic-ai-community-plugins.md`})]}),`\n`]})})})]}),`\n`,_jsx(_components.p,{children:`The skill covers:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Conceptual mapping`}),` — Python pydantic-ai constructs → TypeScript vibes equivalents`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Step-by-step conversion`}),` — from reading Python source to finished TypeScript`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Worked example`}),` — pydantic-ai-todo → `,_jsx(_components.code,{children:`TodoToolset`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quick reference`}),` — `,_jsx(_components.code,{children:`Toolset\u003cTDeps>`}),`, `,_jsx(_components.code,{children:`tool()`}),`, `,_jsx(_components.code,{children:`plainTool()`}),` snippets`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contributing`}),` — where to add new toolsets and how to open a PR`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/community/overview`,children:`Community`}),` section for existing community toolsets you can use today.`]}),`\n`,_jsx(Heading,{level:`2`,id:`keeping-it-updated`,children:`Keeping it updated`}),`\n`,_jsxs(_components.p,{children:[`The skill is versioned alongside the framework. When you upgrade `,_jsx(_components.code,{children:`@vibesjs/sdk`}),`, re-run the install command to pull the latest skill.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Re-run the same install command to update`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://raw.githubusercontent.com/a7ul/vibes/main/packages/sdk/skills/vibes-sdk.md`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .claude/agents/vibes-sdk.md`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent Skill","description":"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.","href":"/meta/agent-skill","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Install","slug":"install","depth":2,"children":[]},{"title":"Manual install","slug":"manual-install","depth":2,"children":[]},{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"How it works","slug":"how-it-works","depth":2,"children":[]},{"title":"Porting pydantic-ai plugins","slug":"porting-pydantic-ai-plugins","depth":2,"children":[]},{"title":"Keeping it updated","slug":"keeping-it-updated","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"personal-b3af1c31","siteName":"Vibes Agent SDK","title":"Agent Skill - Vibes Agent SDK","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-16T02:54:47.859Z","originalFileLocation":"meta/agent-skill.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vibes Agent SDK\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Skill - Vibes Agent SDK\">\u003cmeta data-mint-head property=\"og:description\" content=\"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vibes Agent SDK\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://vibes-sdk.a7ul.com/meta/agent-skill\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://personal-b3af1c31.mintlify.app/_mintlify/api/og/v2?division=Meta\u0026amp;title=Agent+Skill\u0026amp;description=Give+your+coding+assistant+complete+knowledge+of+%40vibesjs%2Fsdk++-++install+in+one+command.\u0026amp;theme=8b1d408ebe7b7a85d6b1d840\u0026amp;signature=6aab466509b1124b73f0ae85d1ad534ba6f240dfa684aede47004ba8583af110\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent Skill - Vibes Agent SDK\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://personal-b3af1c31.mintlify.app/_mintlify/api/og/v2?division=Meta\u0026amp;title=Agent+Skill\u0026amp;description=Give+your+coding+assistant+complete+knowledge+of+%40vibesjs%2Fsdk++-++install+in+one+command.\u0026amp;theme=8b1d408ebe7b7a85d6b1d840\u0026amp;signature=6aab466509b1124b73f0ae85d1ad534ba6f240dfa684aede47004ba8583af110\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/personal-b3af1c31/bA9_RFa3pHGAX5kg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vibes Agent SDK\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://vibes-sdk.a7ul.com/meta/agent-skill\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/meta/agent-skill.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://vibes-sdk.a7ul.com/#organization\",\"name\":\"Vibes Agent SDK\",\"url\":\"https://vibes-sdk.a7ul.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/personal-b3af1c31/qvI9_ro7L0JRXWH9/logo/light.svg?fit=max\u0026auto=format\u0026n=qvI9_ro7L0JRXWH9\u0026q=85\u0026s=3810b9d4cf0db80f00425a70d0459b2e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://vibes-sdk.a7ul.com#website\",\"name\":\"Vibes Agent SDK\",\"url\":\"https://vibes-sdk.a7ul.com\",\"publisher\":{\"@id\":\"https://vibes-sdk.a7ul.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://vibes-sdk.a7ul.com/meta/agent-skill#webpage\",\"url\":\"https://vibes-sdk.a7ul.com/meta/agent-skill\",\"name\":\"Agent Skill\",\"description\":\"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\",\"dateModified\":\"2026-03-16T02:54:47.859Z\",\"isPartOf\":{\"@id\":\"https://vibes-sdk.a7ul.com#website\"},\"breadcrumb\":{\"@id\":\"https://vibes-sdk.a7ul.com/meta/agent-skill#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://vibes-sdk.a7ul.com/meta/agent-skill#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vibes Agent SDK\",\"item\":\"https://vibes-sdk.a7ul.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Skill\",\"item\":\"https://vibes-sdk.a7ul.com/meta/agent-skill\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://vibes-sdk.a7ul.com/meta/agent-skill#article\",\"headline\":\"Agent Skill\",\"name\":\"Agent Skill\",\"description\":\"Give your coding assistant complete knowledge of @vibesjs/sdk - install in one command.\",\"url\":\"https://vibes-sdk.a7ul.com/meta/agent-skill\",\"mainEntityOfPage\":{\"@id\":\"https://vibes-sdk.a7ul.com/meta/agent-skill#webpage\"},\"dateModified\":\"2026-03-16T02:54:47.859Z\",\"publisher\":{\"@id\":\"https://vibes-sdk.a7ul.com/#organization\"},\"isPartOf\":{\"@id\":\"https://vibes-sdk.a7ul.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vibes Agent SDK\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vibes Agent SDK","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Vibes Agent SDK","href":"/index"},{"title":"Introduction","href":"/introduction"},{"title":"Installation","href":"/getting-started/install"},{"title":"Hello World","href":"/getting-started/hello-world"},{"title":"Troubleshooting","href":"/getting-started/troubleshooting"},{"title":"Getting Help","href":"/getting-started/getting-help"}]},{"group":"Concepts","pages":[{"title":"Agents","href":"/concepts/agents"},{"title":"Models","href":"/concepts/models"},{"title":"Dependencies","href":"/concepts/dependencies"},{"title":"Tools","href":"/concepts/tools"},{"title":"Toolsets","href":"/concepts/toolsets"},{"title":"Built-in Toolsets","href":"/concepts/built-in-tools"},{"title":"Tool Patterns","href":"/concepts/tool-patterns"},{"title":"Results","href":"/concepts/results"},{"title":"Messages and Chat History","href":"/concepts/messages"},{"title":"Streaming","href":"/concepts/streaming"},{"title":"Usage Limits","href":"/concepts/usage-limits"},{"title":"Human-in-the-Loop","href":"/concepts/human-in-the-loop"},{"title":"Testing","href":"/concepts/testing"},{"title":"Evaluation Framework","href":"/concepts/evals"},{"title":"Debugging and Monitoring","href":"/concepts/debugging"},{"title":"Multi-Agent Systems","href":"/concepts/multi-agent"},{"title":"Graph Workflows","href":"/concepts/graph"},{"title":"Graph Patterns","href":"/concepts/graph-patterns"},{"title":"Thinking / Extended Reasoning","href":"/concepts/thinking"}]},{"group":"Integrations","pages":[{"title":"MCP Client","href":"/integrations/mcp-client"},{"title":"MCP Server","href":"/integrations/mcp-server"},{"title":"AG-UI","href":"/integrations/ag-ui"},{"title":"A2A (Agent-to-Agent)","href":"/integrations/a2a"},{"title":"Temporal","href":"/integrations/temporal"},{"title":"Vercel AI UI","href":"/integrations/vercel-ai-ui"}]},{"group":"Community","pages":[{"title":"Community Toolsets","href":"/community/overview"},{"title":"TodoToolset","href":"/community/todo-toolset"},{"title":"SkillsToolset","href":"/community/skills-toolset"},{"title":"MemoryToolset","href":"/community/memory-toolset"},{"title":"Publishing Custom Toolsets","href":"/community/third-party-tools"}]},{"group":"Examples","pages":[{"title":"Examples","href":"/examples/index"},{"title":"Hello World","href":"/examples/hello-world"},{"title":"Weather Agent","href":"/examples/weather-agent"},{"title":"Chat App","href":"/examples/chat-app"},{"title":"Bank Support","href":"/examples/bank-support"},{"title":"RAG (Retrieval-Augmented Generation)","href":"/examples/rag"},{"title":"Graph Workflow","href":"/examples/graph-workflow"},{"title":"Human-in-the-Loop","href":"/examples/human-in-the-loop"},{"title":"A2A (Agent-to-Agent)","href":"/examples/a2a"}]},{"group":"Advanced","pages":[{"title":"Multimodal","href":"/advanced/multimodal"},{"title":"Error Handling","href":"/advanced/error-handling"},{"title":"HTTP Retries","href":"/advanced/http-retries"},{"title":"Direct Model Requests","description":"Call AI models directly with generateText and streamText when you don't need the agent wrapper.","href":"/advanced/direct-model-requests"}]},{"group":"Meta","pages":[{"title":"Agent Skill","href":"/meta/agent-skill"},{"title":"Auto-Updates from Pydantic AI","description":"How @vibesjs/sdk tracks Pydantic AI releases and stays up to date.","href":"/meta/auto-updates"},{"title":"Acknowledgments","href":"/meta/acknowledgments"},{"title":"Contributing","href":"/meta/contributing"},{"title":"Feature Parity","href":"/reference/features"}]}]},"basePath":"","title":"Agent Skill - Vibes Agent SDK","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":[],"chunks":[]}
