[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71V86CFGGT33XS5FCVAYPVG":3,"skill-same:01M71V86CFGGT33XS5FCVAYPVG":92},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":32,"linkOnly":33,"markdownContent":34,"markdownBody":35,"frontMatter":36,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":43,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M71V86CFGGT33XS5FCVAYPVG","setup",null,"Setup and configure assistant-ui in a project. Use when installing packages, configuring runtimes, setting up chat UI, or troubleshooting setup issues.","AkaraChen\u002Fangel-engine","AkaraChen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F85140972?v=4","01M6E197RY34TPAFK03227R387","01M71V2QPZM89DQ8R1AB7021P4",19,"MIT","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002FSKILL.md",[],[5,18,19,20,21,22,23,24,25,26,27,28,29,30,31],"assistant","packages","issues","ui","configure","troubleshooting","use","up","chat","project","runtimes","chat ui","when","setting","2026-11-10 13:02:02",false,"---\nname: setup\ndescription: Setup and configure assistant-ui in a project. Use when installing packages, configuring runtimes, setting up chat UI, or troubleshooting setup issues.\nversion: 0.1.0\nlicense: MIT\n---\n\n# assistant-ui Setup\n\n## CLI Commands\n\n### Quick Decision Flow\n\n- Existing Next.js app (`package.json` exists): use `npx assistant-ui@latest init`\n- Existing app in CI\u002Fagent\u002Fnon-interactive shell: use `npx assistant-ui@latest init --yes`\n- Existing app + force overwrite of conflicts: add `--overwrite`\n- New app \u002F empty directory: use `npx assistant-ui@latest create \u003Cname>`\n- Need specific starter template: add `-t \u003Cdefault|minimal|cloud|cloud-clerk|langgraph|mcp>`\n- Need a curated example: use `npx assistant-ui@latest create \u003Cname> --example \u003Cexample>`\n- Need playground preset config: use `npx assistant-ui@latest create \u003Cname> --preset \u003Curl>`\n\n### New Project (`create`)\n\n```bash\nnpx assistant-ui@latest create my-app -t minimal\nnpx assistant-ui@latest create my-app -t cloud-clerk\nnpx assistant-ui@latest create my-app --preset \"https:\u002F\u002Fwww.assistant-ui.com\u002Fplayground\u002Finit?preset=chatgpt\"\n```\n\nTemplates:\n\n| Template | Description |\n|-------|-------|\n| `default` | Default template with Vercel AI SDK |\n| `minimal` | Bare-bones starting point |\n| `cloud` | Cloud-backed persistence starter |\n| `cloud-clerk` | Cloud-backed starter with Clerk auth |\n| `langgraph` | LangGraph starter template |\n| `mcp` | MCP starter template |\n\nWhen `-t` is omitted:\n- Interactive shell (TTY): an interactive template picker is shown.\n- Non-interactive shell (CI\u002Fagent): template defaults to `default`.\n\nIf no project directory is provided in a non-interactive shell, `create` uses `my-aui-app`.\n\n### Existing Next.js Project (`init`)\n\n```bash\nnpx assistant-ui@latest init --yes\n```\n\nThe `init` command is for **existing projects only** (requires `package.json`).\nIf no project is found, it automatically forwards to `create`.\nPassing `--preset` to `init` also forwards to `create` (compatibility path).\n\nThe `--yes` flag runs non-interactively (no prompts).\n\n### Add Registry Components\n\n```bash\nnpx assistant-ui@latest add markdown-text\nnpx assistant-ui@latest add thread-list\n```\n\nRegistry: `https:\u002F\u002Fr.assistant-ui.com\u002F{name}.json`\n\n---\n\n## Template Code Policy\n\nWhen using CLI templates (`npx assistant-ui@latest create`), **never modify generated code** unless explicitly requested.\n\n---\n\n## Non-Default Setups\n\nFor runtimes other than AI SDK or frameworks other than Next.js, consult the reference files:\n\n| Setup | Runtime Hook | Reference |\n|-------|-------------|-----------|\n| AI SDK advanced (tools, cloud, options) | `useChatRuntime` | [references\u002Fai-sdk.md](.\u002Freferences\u002Fai-sdk.md) |\n| Styling and UI customization (shadcn pattern) | — | [references\u002Fstyling.md](.\u002Freferences\u002Fstyling.md) |\n| LangGraph agents | `useLangGraphRuntime` | [references\u002Flanggraph.md](.\u002Freferences\u002Flanggraph.md) |\n| AG-UI protocol | `useAgUiRuntime` | [references\u002Fag-ui.md](.\u002Freferences\u002Fag-ui.md) |\n| A2A protocol | `useA2ARuntime` | [references\u002Fa2a.md](.\u002Freferences\u002Fa2a.md) |\n| Custom streaming API | `useLocalRuntime` | [references\u002Fcustom-backend.md](.\u002Freferences\u002Fcustom-backend.md) |\n| Existing state (Redux\u002FZustand) | `useExternalStoreRuntime` | [references\u002Fcustom-backend.md](.\u002Freferences\u002Fcustom-backend.md) |\n| Vite \u002F TanStack Start | — | [references\u002Ftanstack.md](.\u002Freferences\u002Ftanstack.md) |\n\n---\n\n## Deprecated Packages\n\nNEVER install `@assistant-ui\u002Fstyles` or `@assistant-ui\u002Freact-ui` — both are deprecated and deleted.\n\n---\n\n## Troubleshooting\n\nFor issues not covered by the reference files, use the docs website:\n\n1. **Fetch the index**: `https:\u002F\u002Fwww.assistant-ui.com\u002Fllms.txt` — compact table of contents\n2. **Fetch specific pages**: Append `.mdx` to the docs URL, e.g. `https:\u002F\u002Fwww.assistant-ui.com\u002Fdocs\u002Fruntimes\u002Fai-sdk.mdx`\n","# assistant-ui Setup\n\n## CLI Commands\n\n### Quick Decision Flow\n\n- Existing Next.js app (`package.json` exists): use `npx assistant-ui@latest init`\n- Existing app in CI\u002Fagent\u002Fnon-interactive shell: use `npx assistant-ui@latest init --yes`\n- Existing app + force overwrite of conflicts: add `--overwrite`\n- New app \u002F empty directory: use `npx assistant-ui@latest create \u003Cname>`\n- Need specific starter template: add `-t \u003Cdefault|minimal|cloud|cloud-clerk|langgraph|mcp>`\n- Need a curated example: use `npx assistant-ui@latest create \u003Cname> --example \u003Cexample>`\n- Need playground preset config: use `npx assistant-ui@latest create \u003Cname> --preset \u003Curl>`\n\n### New Project (`create`)\n\n```bash\nnpx assistant-ui@latest create my-app -t minimal\nnpx assistant-ui@latest create my-app -t cloud-clerk\nnpx assistant-ui@latest create my-app --preset \"https:\u002F\u002Fwww.assistant-ui.com\u002Fplayground\u002Finit?preset=chatgpt\"\n```\n\nTemplates:\n\n| Template | Description |\n|-------|-------|\n| `default` | Default template with Vercel AI SDK |\n| `minimal` | Bare-bones starting point |\n| `cloud` | Cloud-backed persistence starter |\n| `cloud-clerk` | Cloud-backed starter with Clerk auth |\n| `langgraph` | LangGraph starter template |\n| `mcp` | MCP starter template |\n\nWhen `-t` is omitted:\n- Interactive shell (TTY): an interactive template picker is shown.\n- Non-interactive shell (CI\u002Fagent): template defaults to `default`.\n\nIf no project directory is provided in a non-interactive shell, `create` uses `my-aui-app`.\n\n### Existing Next.js Project (`init`)\n\n```bash\nnpx assistant-ui@latest init --yes\n```\n\nThe `init` command is for **existing projects only** (requires `package.json`).\nIf no project is found, it automatically forwards to `create`.\nPassing `--preset` to `init` also forwards to `create` (compatibility path).\n\nThe `--yes` flag runs non-interactively (no prompts).\n\n### Add Registry Components\n\n```bash\nnpx assistant-ui@latest add markdown-text\nnpx assistant-ui@latest add thread-list\n```\n\nRegistry: `https:\u002F\u002Fr.assistant-ui.com\u002F{name}.json`\n\n---\n\n## Template Code Policy\n\nWhen using CLI templates (`npx assistant-ui@latest create`), **never modify generated code** unless explicitly requested.\n\n---\n\n## Non-Default Setups\n\nFor runtimes other than AI SDK or frameworks other than Next.js, consult the reference files:\n\n| Setup | Runtime Hook | Reference |\n|-------|-------------|-----------|\n| AI SDK advanced (tools, cloud, options) | `useChatRuntime` | [references\u002Fai-sdk.md](.\u002Freferences\u002Fai-sdk.md) |\n| Styling and UI customization (shadcn pattern) | — | [references\u002Fstyling.md](.\u002Freferences\u002Fstyling.md) |\n| LangGraph agents | `useLangGraphRuntime` | [references\u002Flanggraph.md](.\u002Freferences\u002Flanggraph.md) |\n| AG-UI protocol | `useAgUiRuntime` | [references\u002Fag-ui.md](.\u002Freferences\u002Fag-ui.md) |\n| A2A protocol | `useA2ARuntime` | [references\u002Fa2a.md](.\u002Freferences\u002Fa2a.md) |\n| Custom streaming API | `useLocalRuntime` | [references\u002Fcustom-backend.md](.\u002Freferences\u002Fcustom-backend.md) |\n| Existing state (Redux\u002FZustand) | `useExternalStoreRuntime` | [references\u002Fcustom-backend.md](.\u002Freferences\u002Fcustom-backend.md) |\n| Vite \u002F TanStack Start | — | [references\u002Ftanstack.md](.\u002Freferences\u002Ftanstack.md) |\n\n---\n\n## Deprecated Packages\n\nNEVER install `@assistant-ui\u002Fstyles` or `@assistant-ui\u002Freact-ui` — both are deprecated and deleted.\n\n---\n\n## Troubleshooting\n\nFor issues not covered by the reference files, use the docs website:\n\n1. **Fetch the index**: `https:\u002F\u002Fwww.assistant-ui.com\u002Fllms.txt` — compact table of contents\n2. **Fetch specific pages**: Append `.mdx` to the docs URL, e.g. `https:\u002F\u002Fwww.assistant-ui.com\u002Fdocs\u002Fruntimes\u002Fai-sdk.mdx`\n",{"name":5,"license":14,"version":37,"description":7},"0.1.0","master","48a57981043dbb2c534a27f410715a205f50bcfb",".claude\u002Fskills\u002Fsetup",2,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine","https:\u002F\u002Fangel-engine.vercel.app\u002F","https:\u002F\u002Fgithub.com\u002FAkaraChen","https:\u002F\u002Fakr.moe","button painter, string concatenator, log alchemist.\r\n\r\nNo slop, no lag.","2026-09-09 08:58:26",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add AkaraChen\u002Fangel-engine --skill setup",{"tool":54,"command":55},"bunx","bunx skills add AkaraChen\u002Fangel-engine --skill setup",{"tool":57,"command":58},"pnpm","pnpm dlx skills add AkaraChen\u002Fangel-engine --skill setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002FSKILL.md",true,[62,68,72,76,80,84,88],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fa2a.md","REFERENCE","参考文档",3896,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Fa2a.md",{"path":69,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fag-ui.md",2720,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Fag-ui.md",{"path":73,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fai-sdk.md",8540,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Fai-sdk.md",{"path":77,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fcustom-backend.md",9118,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Fcustom-backend.md",{"path":81,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Flanggraph.md",5184,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Flanggraph.md",{"path":85,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fstyling.md",2885,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Fstyling.md",{"path":89,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Ftanstack.md",3795,"https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fsetup\u002Freferences\u002Ftanstack.md",[93,105,130,146,158,171],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":32},"01M71V8NX6JM9719CJM1R07JNF","update","Update assistant-ui and AI SDK to latest versions. Detects current versions, identifies breaking changes, and executes migrations.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fupdate\u002FSKILL.md",[],[95,100,101,102,103,104,18,21],"ai sdk","migrations","latest","changes","sdk",{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":116,"publishedAt":32},"01M71V8GA53EWDYMKDCE95JN9M","tools","Guide for tool registration and tool UI in assistant-ui. Use when implementing LLM tools, tool call rendering, or human-in-the-loop patterns.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Ftools\u002FSKILL.md",[111],{"categoryNo":112,"categoryName":113,"taxonomyType":114,"taxonomyTypeDesc":115},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[117,21,18,118,119,30,120,121,122,123,124,125,126,24,127,128,129],"Tools","human-in-the-loop","call","for","implementing","rendering","human","llm tools","patterns","registration","guide","tool","loop",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":32},"01M71V8EK5HG1TY1JSJA9ZG6RA","thread-list","Guide for multi-thread management in assistant-ui. Use when implementing thread lists, switching threads, or managing conversation history.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fthread-list\u002FSKILL.md",[],[137,138,139,121,30,120,140,141,142,143,24,127,144,18,21,145],"list","thread","thread list","threads","multi","switching","conversation","management","history",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":152,"publishedAt":32},"01M71V8CQ30TTQP2KHPYCGCR3R","streaming","Guide for assistant-stream package and streaming protocols. Use when implementing streaming backends, custom protocols, or debugging stream issues.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fstreaming\u002FSKILL.md",[],[148,153,30,154,155,120,121,24,127,156,20,157,18],"protocols","custom","stream","package","debugging",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":164,"publishedAt":32},"01M71V84DGS3SN4VJ829MHNBB8","runtime","Guide for assistant-ui runtime system and state management. Use when working with runtimes, accessing state, or managing thread\u002Fmessage data.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fruntime\u002FSKILL.md",[],[160,18,165,24,127,144,166,167,21,168,169,28,30,138,120,170],"message","system","data","state","state management","with",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":32},"01M71V82YXWTCQS0M06D2HK4C4","primitives","Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive. Use when customizing chat UI components.","https:\u002F\u002Fgithub.com\u002FAkaraChen\u002Fangel-engine\u002Fblob\u002Fmaster\u002F.claude\u002Fskills\u002Fprimitives\u002FSKILL.md",[],[173,30,120,29,178,26,24,127,21,179,18],"ui components","components"]