[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CCC2KVHGYK9TGKYY403SC9":3,"skill-same:01M6CCC2KVHGYK9TGKYY403SC9":99},{"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":32,"linkOnly":33,"markdownContent":34,"markdownBody":35,"frontMatter":36,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":14,"repositoryHtmlUrl":40,"repositoryHomepageUrl":41,"ownerHtmlUrl":42,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":43,"install":44,"resources":57},"01M6CCC2KVHGYK9TGKYY403SC9","convex-setup-auth",null,"Set up Convex authentication with proper user management, identity mapping, and access control patterns. Use when implementing auth flows.","baisharg\u002FASTN","baisharg","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F204916775?v=4","01M6CC8XHZYVK2DR22FZ1BESCG","BAISH","01M6CC8XP400QZ9DXAWTC8EG3X",2,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31],"convex setup auth","convex","auth","setup","setup auth","identity","authentication","SET","access","management","user","use","up","2026-11-10 10:12:30",false,"---\nname: convex-setup-auth\ndescription: Set up Convex authentication with proper user management, identity mapping, and access control patterns. Use when implementing auth flows.\n---\n\n# Convex Authentication Setup\n\nImplement secure authentication in Convex with user management and access control.\n\n## When to Use\n\n- Setting up authentication for the first time\n- Implementing user management (users table, identity mapping)\n- Creating authentication helper functions\n- Setting up auth providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, custom JWT)\n\n## First Step: Choose the Auth Provider\n\nConvex supports multiple authentication approaches. Do not assume a provider.\n\nBefore writing setup code:\n\n1. Ask the user which auth solution they want, unless the repository already makes it obvious\n2. If the repo already uses a provider, continue with that provider unless the user wants to switch\n3. If the user has not chosen a provider and the repo does not make it obvious, ask before proceeding\n\nCommon options:\n\n- [Convex Auth](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fconvex-auth) - good default when the user wants auth handled directly in Convex\n- [Clerk](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fclerk) - use when the app already uses Clerk or the user wants Clerk's hosted auth features\n- [WorkOS AuthKit](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauthkit\u002F) - use when the app already uses WorkOS or the user wants AuthKit specifically\n- [Auth0](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauth0) - use when the app already uses Auth0\n- Custom JWT provider - use when integrating an existing auth system not covered above\n\nLook for signals in the repo before asking:\n\n- Dependencies such as `@clerk\u002F*`, `@workos-inc\u002F*`, `@auth0\u002F*`, or Convex Auth packages\n- Existing files such as `convex\u002Fauth.config.ts`, auth middleware, provider wrappers, or login components\n- Environment variables that clearly point at a provider\n\n## After Choosing a Provider\n\nRead the provider's official guide and the matching local reference file:\n\n- Convex Auth: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fconvex-auth), then `references\u002Fconvex-auth.md`\n- Clerk: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fclerk), then `references\u002Fclerk.md`\n- WorkOS AuthKit: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauthkit\u002F), then `references\u002Fworkos-authkit.md`\n- Auth0: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauth0), then `references\u002Fauth0.md`\n\nThe local reference files contain the concrete workflow, expected files and env vars, gotchas, and validation checks.\n\nUse those sources for:\n\n- package installation\n- client provider wiring\n- environment variables\n- `convex\u002Fauth.config.ts` setup\n- login and logout UI patterns\n- framework-specific setup for React, Vite, or Next.js\n\nFor shared auth behavior, use the official Convex docs as the source of truth:\n\n- [Auth in Functions](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Ffunctions-auth) for `ctx.auth.getUserIdentity()`\n- [Storing Users in the Convex Database](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fdatabase-auth) for optional app-level user storage\n- [Authentication](https:\u002F\u002Fdocs.convex.dev\u002Fauth) for general auth and authorization guidance\n- [Convex Auth Authorization](https:\u002F\u002Flabs.convex.dev\u002Fauth\u002Fauthz) when the provider is Convex Auth\n\nDo not invent a provider-agnostic user sync pattern from memory.\nFor third-party providers, only add app-level user storage if the app actually needs user documents in Convex.\nFor Convex Auth, do not add a parallel `users` table plus `storeUser` flow. Follow the Convex Auth docs and built-in auth tables instead.\n\nDo not invent provider-specific setup from memory when the docs are available.\nDo not assume provider initialization commands finish the entire integration. Verify generated files and complete the post-init wiring steps the provider reference calls out.\n\n## Workflow\n\n1. Determine the provider, either by asking the user or inferring from the repo\n2. Ask whether the user wants local-only setup or production-ready setup now\n3. Read the matching provider reference file\n4. Follow the official provider docs for current setup details\n5. Follow the official Convex docs for shared backend auth behavior, user storage, and authorization patterns\n6. Only add app-level user storage if the docs and app requirements call for it\n7. Add authorization checks for ownership, roles, or team access only where the app needs them\n8. Verify login state, protected queries, environment variables, and production configuration if requested\n\nIf the flow blocks on interactive provider or deployment setup, ask the user explicitly for the exact human step needed, then continue after they complete it.\nFor UI-facing auth flows, offer to validate the real sign-up or sign-in flow after setup is done.\nIf the environment has browser automation tools, you can use them.\nIf it does not, give the user a short manual validation checklist instead.\n\n## Reference Files\n\n### Provider References\n\n- `references\u002Fconvex-auth.md`\n- `references\u002Fclerk.md`\n- `references\u002Fworkos-authkit.md`\n- `references\u002Fauth0.md`\n\n## Checklist\n\n- [ ] Chosen the correct auth provider before writing setup code\n- [ ] Read the relevant provider reference file\n- [ ] Asked whether the user wants local-only setup or production-ready setup\n- [ ] Used the official provider docs for provider-specific wiring\n- [ ] Used the official Convex docs for shared auth behavior and authorization patterns\n- [ ] Only added app-level user storage if the app actually needs it\n- [ ] Did not invent a cross-provider `users` table or `storeUser` flow for Convex Auth\n- [ ] Added authentication checks in protected backend functions\n- [ ] Added authorization checks where the app actually needs them\n- [ ] Clear error messages (\"Not authenticated\", \"Unauthorized\")\n- [ ] Client auth provider configured for the chosen provider\n- [ ] If requested, production auth setup is covered too\n","# Convex Authentication Setup\n\nImplement secure authentication in Convex with user management and access control.\n\n## When to Use\n\n- Setting up authentication for the first time\n- Implementing user management (users table, identity mapping)\n- Creating authentication helper functions\n- Setting up auth providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, custom JWT)\n\n## First Step: Choose the Auth Provider\n\nConvex supports multiple authentication approaches. Do not assume a provider.\n\nBefore writing setup code:\n\n1. Ask the user which auth solution they want, unless the repository already makes it obvious\n2. If the repo already uses a provider, continue with that provider unless the user wants to switch\n3. If the user has not chosen a provider and the repo does not make it obvious, ask before proceeding\n\nCommon options:\n\n- [Convex Auth](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fconvex-auth) - good default when the user wants auth handled directly in Convex\n- [Clerk](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fclerk) - use when the app already uses Clerk or the user wants Clerk's hosted auth features\n- [WorkOS AuthKit](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauthkit\u002F) - use when the app already uses WorkOS or the user wants AuthKit specifically\n- [Auth0](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauth0) - use when the app already uses Auth0\n- Custom JWT provider - use when integrating an existing auth system not covered above\n\nLook for signals in the repo before asking:\n\n- Dependencies such as `@clerk\u002F*`, `@workos-inc\u002F*`, `@auth0\u002F*`, or Convex Auth packages\n- Existing files such as `convex\u002Fauth.config.ts`, auth middleware, provider wrappers, or login components\n- Environment variables that clearly point at a provider\n\n## After Choosing a Provider\n\nRead the provider's official guide and the matching local reference file:\n\n- Convex Auth: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fconvex-auth), then `references\u002Fconvex-auth.md`\n- Clerk: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fclerk), then `references\u002Fclerk.md`\n- WorkOS AuthKit: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauthkit\u002F), then `references\u002Fworkos-authkit.md`\n- Auth0: [official docs](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fauth0), then `references\u002Fauth0.md`\n\nThe local reference files contain the concrete workflow, expected files and env vars, gotchas, and validation checks.\n\nUse those sources for:\n\n- package installation\n- client provider wiring\n- environment variables\n- `convex\u002Fauth.config.ts` setup\n- login and logout UI patterns\n- framework-specific setup for React, Vite, or Next.js\n\nFor shared auth behavior, use the official Convex docs as the source of truth:\n\n- [Auth in Functions](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Ffunctions-auth) for `ctx.auth.getUserIdentity()`\n- [Storing Users in the Convex Database](https:\u002F\u002Fdocs.convex.dev\u002Fauth\u002Fdatabase-auth) for optional app-level user storage\n- [Authentication](https:\u002F\u002Fdocs.convex.dev\u002Fauth) for general auth and authorization guidance\n- [Convex Auth Authorization](https:\u002F\u002Flabs.convex.dev\u002Fauth\u002Fauthz) when the provider is Convex Auth\n\nDo not invent a provider-agnostic user sync pattern from memory.\nFor third-party providers, only add app-level user storage if the app actually needs user documents in Convex.\nFor Convex Auth, do not add a parallel `users` table plus `storeUser` flow. Follow the Convex Auth docs and built-in auth tables instead.\n\nDo not invent provider-specific setup from memory when the docs are available.\nDo not assume provider initialization commands finish the entire integration. Verify generated files and complete the post-init wiring steps the provider reference calls out.\n\n## Workflow\n\n1. Determine the provider, either by asking the user or inferring from the repo\n2. Ask whether the user wants local-only setup or production-ready setup now\n3. Read the matching provider reference file\n4. Follow the official provider docs for current setup details\n5. Follow the official Convex docs for shared backend auth behavior, user storage, and authorization patterns\n6. Only add app-level user storage if the docs and app requirements call for it\n7. Add authorization checks for ownership, roles, or team access only where the app needs them\n8. Verify login state, protected queries, environment variables, and production configuration if requested\n\nIf the flow blocks on interactive provider or deployment setup, ask the user explicitly for the exact human step needed, then continue after they complete it.\nFor UI-facing auth flows, offer to validate the real sign-up or sign-in flow after setup is done.\nIf the environment has browser automation tools, you can use them.\nIf it does not, give the user a short manual validation checklist instead.\n\n## Reference Files\n\n### Provider References\n\n- `references\u002Fconvex-auth.md`\n- `references\u002Fclerk.md`\n- `references\u002Fworkos-authkit.md`\n- `references\u002Fauth0.md`\n\n## Checklist\n\n- [ ] Chosen the correct auth provider before writing setup code\n- [ ] Read the relevant provider reference file\n- [ ] Asked whether the user wants local-only setup or production-ready setup\n- [ ] Used the official provider docs for provider-specific wiring\n- [ ] Used the official Convex docs for shared auth behavior and authorization patterns\n- [ ] Only added app-level user storage if the app actually needs it\n- [ ] Did not invent a cross-provider `users` table or `storeUser` flow for Convex Auth\n- [ ] Added authentication checks in protected backend functions\n- [ ] Added authorization checks where the app actually needs them\n- [ ] Clear error messages (\"Not authenticated\", \"Unauthorized\")\n- [ ] Client auth provider configured for the chosen provider\n- [ ] If requested, production auth setup is covered too\n",{"name":5,"description":7},"main","83212e6d909b6a0fe9e93fd5a3ff1723300f5b5b",".agents\u002Fskills\u002Fconvex-setup-auth","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN","https:\u002F\u002Fsafetytalent.org","https:\u002F\u002Fgithub.com\u002Fbaisharg","2026-11-04 07:01:33",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add baisharg\u002FASTN --skill convex-setup-auth",{"tool":50,"command":51},"bunx","bunx skills add baisharg\u002FASTN --skill convex-setup-auth",{"tool":53,"command":54},"pnpm","pnpm dlx skills add baisharg\u002FASTN --skill convex-setup-auth","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002FSKILL.md",true,[58,64,70,75,79,83,87,91,95],{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"agents\u002Fopenai.yaml","REFERENCE","参考文档",469,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Fagents\u002Fopenai.yaml",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"assets\u002Ficon.svg","ASSET","资产文件",394,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Fassets\u002Ficon.svg",{"path":71,"resourceType":71,"resourceTypeDesc":72,"sizeBytes":73,"sourceHtmlUrl":74},"LICENSE","许可证",1063,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Fpendle-finance-official-boros-data\u002FLICENSE",{"path":76,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fauth0.md",7440,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Freferences\u002Fauth0.md",{"path":80,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fclerk.md",6283,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Freferences\u002Fclerk.md",{"path":84,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fconvex-auth.md",8286,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Freferences\u002Fconvex-auth.md",{"path":88,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fworkos-authkit.md",6248,"https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fconvex-setup-auth\u002Freferences\u002Fworkos-authkit.md",{"path":92,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":93,"sourceHtmlUrl":94},"SOURCE.md",381,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Fpendle-finance-official-boros-data\u002FSOURCE.md",{"path":96,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":97,"sourceHtmlUrl":98},"TRUST.auto.yaml",2210,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Fpendle-finance-official-boros-data\u002FTRUST.auto.yaml",[100,121,135,149,163,180],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":111,"publishedAt":32},"01M6CCE5DVER8DQWJDY51HAJF7","schema-builder","Design and generate Convex database schemas with proper validation, indexes, and relationships. Use when creating schema.ts or modifying table definitions.","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fschema-builder\u002FSKILL.md",[106],{"categoryNo":107,"categoryName":108,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[112,113,114,115,116,30,117,118,119,20,120],"schema builder","schema","builder","indexes","validation","table","database","design","generate",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":32},"01M6CCE36AA57CG36R4VHKFRXV","integration-tanstack-start","PostHog integration for TanStack Start full-stack applications","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fposthog-integration-tanstack-start\u002FSKILL.md",[],[128,129,130,131,132,133,134],"integration","start","tanstack","integration tanstack start","posthog","applications","stack",{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":141,"publishedAt":32},"01M6CCE0FK6N8XAB093X7TTQ4F","migration-helper","Plan and execute Convex schema migrations safely, including adding fields, creating tables, and data transformations. Use when schema changes affect existing data.","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmigration-helper\u002FSKILL.md",[],[142,143,144,145,146,147,30,113,148,20],"migration","migration helper","schema migrations safely","data","plan","execute","migrations",{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":155,"publishedAt":32},"01M6CCDY3644G8WXXP0BDNMZPR","gsd:sprint","Autonomous phase execution with Codex validation. Runs plan\u002Fexecute\u002Fverify cycles in a bash loop until done or halted.","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgsd-sprint\u002FSKILL.md",[],[151,156,157,116,129,158,159,160,161,146,162,147],"resume","codex","execution","verify","Bash","loop","autonomous",{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":32},"01M6CCDVTZRTFWWGREMV6FF956","gsd:second-opinion","Get a second opinion from OpenAI Codex (GPT-5.2-codex) on code, architecture, or implementation decisions. Use when you want independent verification or an alternative perspective.","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgsd-second-opinion\u002FSKILL.md",[],[170,171,172,157,173,174,175,176,177,178,30,179],"gsd:second opinion","second opinion","question","architecture","code","verification","openai","gpt","decisions","implementation",{"skillNo":181,"name":182,"nameZh":6,"description":183,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":184,"categories":185,"keywords":186,"publishedAt":32},"01M6CCDSDPYYNEDERHP01N30PT","gsd:milestone-sprint","Run entire milestone autonomously with Codex validation. Auto-detects current milestone, executes all phases, and runs audit.","https:\u002F\u002Fgithub.com\u002Fbaisharg\u002FASTN\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fgsd-milestone-sprint\u002FSKILL.md",[],[187,188,116,189,190,191,156,157],"gsd:milestone sprint","run","audit","interactive","auto"]