[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M758SVMY6HAPF2WMZ894E995":3,"skill-same:01M758SVMY6HAPF2WMZ894E995":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":28,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M758SVMY6HAPF2WMZ894E995","constants-configuration-pattern",null,"Centralize all configuration constants — environment variables, cache keys — in the constants\u002F directory with strict naming and export conventions","CliqRelay\u002Fcliqrelay","CliqRelay","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F290753656?v=4","01M758RPDEB11FEYA2XK17DSHA","01M758RPEKP0NKH6P43GD2FBDG",41,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ffrontend\u002Fconstants-configuration-pattern\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: constants-configuration-pattern\ndescription: Centralize all configuration constants — environment variables, cache keys — in the constants\u002F directory with strict naming and export conventions\n---\n\n# Constants & Configuration Pattern\n\nAll configuration and constant values are centralized in `constants\u002F`, organized by concern. No hardcoded strings in service or component files.\n\n## Key Change: API Endpoints No Longer Manual\n\nWith `@repo\u002Fapi-client`, API endpoint URLs are **no longer defined manually**. The auto-generated SDK handles all URL construction using `import.meta.env.VITE_API_URL` (set via `@t3-oss\u002Fenv-core`). See [env.ts](#environment-config-constantsenvts) below.\n\nFor domains not covered by `@repo\u002Fapi-client`, API endpoints can still be defined — see the legacy pattern at the end of this document.\n\n## Folder Structure\n\n```\nconstants\u002F\n├── env.ts                ← Environment variables (required)\n├── query-keys.ts         ← Cache keys (when using manual TanStack React Query)\n└── index.ts              ← Optional re-exports\n```\n\n## Environment Config (`constants\u002Fenv.ts`)\n\nUse `@t3-oss\u002Fenv-core` with Zod schemas for validated, typed environment variables. Choose the example that matches your framework.\n\n### Vite \u002F TanStack Start\n\nUses `import.meta.env` with `VITE_` prefix:\n\n```typescript\n\u002F\u002F constants\u002Fenv.ts\nimport { createEnv } from \"@t3-oss\u002Fenv-core\";\nimport { z } from \"zod\";\n\nexport const env = createEnv({\n  server: {\n    DATABASE_URL: z.string().nonempty(),\n    API_SECRET: z.string().nonempty()\n  },\n\n  clientPrefix: \"VITE_\",\n  client: {\n    VITE_API_URL: z.string().nonempty().url(),\n    VITE_BASE_URL: z.string().nonempty().url(),\n    VITE_APP_NAME: z.string().nonempty(),\n    VITE_APP_VERSION: z.string().nonempty()\n  },\n\n  runtimeEnv: import.meta.env,\n  emptyStringAsUndefined: true\n});\n```\n\n> **Note:** `VITE_API_URL` is consumed by `@repo\u002Fapi-client` (Orval config reads `import.meta.env.VITE_API_URL`). No manual URL construction needed.\n\n### ✅ DO — Use `createEnv` with Zod for validated env vars\n### ✅ DO — Separate `server` and `client` blocks\n### ✅ DO — Set `emptyStringAsUndefined: true`\n### ✅ DO — Use `VITE_` prefix for client variables\n### ❌ DON'T — Access raw env vars directly in service\u002Fhook files\n\n```typescript\n\u002F\u002F ❌ DON'T — Raw access\nconst apiUrl = import.meta.env.VITE_API_URL;\n\n\u002F\u002F ✅ DO — Always import from .\u002Fenv\nimport { env } from \"[project-root]\u002Fconstants\u002Fenv\";\nconst apiUrl = env.VITE_API_URL;\n```\n\n## If Using Manual TanStack React Query (Non-api-client Domains)\n\nQuery keys go in `constants\u002Fquery-keys.ts`. QueryClient setup and cache utilities belong in `lib\u002Fquery-client.ts` — see the [React Query Cache Utilities](.\u002Freact-query-cache-utilities\u002FSKILL.md) skill.\n\n## Legacy Pattern: Manual API Endpoints (Non-api-client Domains)\n\nFor domains **not covered by `@repo\u002Fapi-client`**, define API endpoints manually:\n\n```typescript\n\u002F\u002F constants\u002Fapi-endpoints.ts\nimport { env } from \".\u002Fenv\";\n\nconst API_ENDPOINTS = {\n  metadata: {\n    app: `${env.VITE_API_URL}\u002Fapp_metadata`\n  },\n  auth: {\n    createAccount: `${env.VITE_API_URL}\u002Fauth\u002Fcreate_account`\n  },\n  users: {\n    getMe: `${env.VITE_API_URL}\u002Fusers\u002Fme`,\n  },\n} as const;\n\nexport default API_ENDPOINTS;\n```\n\n### ✅ DO — Legacy endpoint conventions\n- `API_ENDPOINTS` uses `as const` for type safety\n- Template literals for URL construction: `` `${env.VITE_API_URL}\u002Fpath` ``\n- Only define endpoints for APIs not covered by `@repo\u002Fapi-client`\n\n### ❌ DON'T — Duplicate what api-client already provides\n```typescript\n\u002F\u002F ❌ DON'T — @repo\u002Fapi-client already defines these URLs\nconst API_ENDPOINTS = {\n  guides: {\n    create: `${env.VITE_API_URL}\u002Fguides`,\n    getAll: `${env.VITE_API_URL}\u002Fguides`,\n  }\n} as const;\n```\n\n## Rules\n\n### ✅ DO\n- Use `createEnv` from `@t3-oss\u002Fenv-core` with Zod for env validation\n- Separate `server` and `client` env vars\n- Set `emptyStringAsUndefined: true`\n- Match `clientPrefix` to your framework's convention\n- Access env through `env` export, never directly from env globals\n- Let `@repo\u002Fapi-client` handle all API URL construction for covered domains\n- Only define manual API endpoints for domains NOT covered by `@repo\u002Fapi-client`\n- Query keys are enum members, not string literals\n- One config concern per file\n\n### ❌ DON'T\n- Don't manually define API endpoints for domains covered by `@repo\u002Fapi-client`\n- Don't access raw env vars in service, hook, or component files\n- Don't mix config concerns in the same file\n- Don't skip Zod validation on environment variables\n","# Constants & Configuration Pattern\n\nAll configuration and constant values are centralized in `constants\u002F`, organized by concern. No hardcoded strings in service or component files.\n\n## Key Change: API Endpoints No Longer Manual\n\nWith `@repo\u002Fapi-client`, API endpoint URLs are **no longer defined manually**. The auto-generated SDK handles all URL construction using `import.meta.env.VITE_API_URL` (set via `@t3-oss\u002Fenv-core`). See [env.ts](#environment-config-constantsenvts) below.\n\nFor domains not covered by `@repo\u002Fapi-client`, API endpoints can still be defined — see the legacy pattern at the end of this document.\n\n## Folder Structure\n\n```\nconstants\u002F\n├── env.ts                ← Environment variables (required)\n├── query-keys.ts         ← Cache keys (when using manual TanStack React Query)\n└── index.ts              ← Optional re-exports\n```\n\n## Environment Config (`constants\u002Fenv.ts`)\n\nUse `@t3-oss\u002Fenv-core` with Zod schemas for validated, typed environment variables. Choose the example that matches your framework.\n\n### Vite \u002F TanStack Start\n\nUses `import.meta.env` with `VITE_` prefix:\n\n```typescript\n\u002F\u002F constants\u002Fenv.ts\nimport { createEnv } from \"@t3-oss\u002Fenv-core\";\nimport { z } from \"zod\";\n\nexport const env = createEnv({\n  server: {\n    DATABASE_URL: z.string().nonempty(),\n    API_SECRET: z.string().nonempty()\n  },\n\n  clientPrefix: \"VITE_\",\n  client: {\n    VITE_API_URL: z.string().nonempty().url(),\n    VITE_BASE_URL: z.string().nonempty().url(),\n    VITE_APP_NAME: z.string().nonempty(),\n    VITE_APP_VERSION: z.string().nonempty()\n  },\n\n  runtimeEnv: import.meta.env,\n  emptyStringAsUndefined: true\n});\n```\n\n> **Note:** `VITE_API_URL` is consumed by `@repo\u002Fapi-client` (Orval config reads `import.meta.env.VITE_API_URL`). No manual URL construction needed.\n\n### ✅ DO — Use `createEnv` with Zod for validated env vars\n### ✅ DO — Separate `server` and `client` blocks\n### ✅ DO — Set `emptyStringAsUndefined: true`\n### ✅ DO — Use `VITE_` prefix for client variables\n### ❌ DON'T — Access raw env vars directly in service\u002Fhook files\n\n```typescript\n\u002F\u002F ❌ DON'T — Raw access\nconst apiUrl = import.meta.env.VITE_API_URL;\n\n\u002F\u002F ✅ DO — Always import from .\u002Fenv\nimport { env } from \"[project-root]\u002Fconstants\u002Fenv\";\nconst apiUrl = env.VITE_API_URL;\n```\n\n## If Using Manual TanStack React Query (Non-api-client Domains)\n\nQuery keys go in `constants\u002Fquery-keys.ts`. QueryClient setup and cache utilities belong in `lib\u002Fquery-client.ts` — see the [React Query Cache Utilities](.\u002Freact-query-cache-utilities\u002FSKILL.md) skill.\n\n## Legacy Pattern: Manual API Endpoints (Non-api-client Domains)\n\nFor domains **not covered by `@repo\u002Fapi-client`**, define API endpoints manually:\n\n```typescript\n\u002F\u002F constants\u002Fapi-endpoints.ts\nimport { env } from \".\u002Fenv\";\n\nconst API_ENDPOINTS = {\n  metadata: {\n    app: `${env.VITE_API_URL}\u002Fapp_metadata`\n  },\n  auth: {\n    createAccount: `${env.VITE_API_URL}\u002Fauth\u002Fcreate_account`\n  },\n  users: {\n    getMe: `${env.VITE_API_URL}\u002Fusers\u002Fme`,\n  },\n} as const;\n\nexport default API_ENDPOINTS;\n```\n\n### ✅ DO — Legacy endpoint conventions\n- `API_ENDPOINTS` uses `as const` for type safety\n- Template literals for URL construction: `` `${env.VITE_API_URL}\u002Fpath` ``\n- Only define endpoints for APIs not covered by `@repo\u002Fapi-client`\n\n### ❌ DON'T — Duplicate what api-client already provides\n```typescript\n\u002F\u002F ❌ DON'T — @repo\u002Fapi-client already defines these URLs\nconst API_ENDPOINTS = {\n  guides: {\n    create: `${env.VITE_API_URL}\u002Fguides`,\n    getAll: `${env.VITE_API_URL}\u002Fguides`,\n  }\n} as const;\n```\n\n## Rules\n\n### ✅ DO\n- Use `createEnv` from `@t3-oss\u002Fenv-core` with Zod for env validation\n- Separate `server` and `client` env vars\n- Set `emptyStringAsUndefined: true`\n- Match `clientPrefix` to your framework's convention\n- Access env through `env` export, never directly from env globals\n- Let `@repo\u002Fapi-client` handle all API URL construction for covered domains\n- Only define manual API endpoints for domains NOT covered by `@repo\u002Fapi-client`\n- Query keys are enum members, not string literals\n- One config concern per file\n\n### ❌ DON'T\n- Don't manually define API endpoints for domains covered by `@repo\u002Fapi-client`\n- Don't access raw env vars in service, hook, or component files\n- Don't mix config concerns in the same file\n- Don't skip Zod validation on environment variables\n",{"name":5,"description":7},"main","f06510bcaf955afc66bbbc1606871e1a1576492e",".agents\u002Fskills\u002Ffrontend\u002Fconstants-configuration-pattern",0,"https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay","https:\u002F\u002Fcliqrelay.com","https:\u002F\u002Fgithub.com\u002FCliqRelay","Capture and refine workflows instantly to help your teams and AI agents perform at their best.","2026-11-04 22:56:05",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add CliqRelay\u002Fcliqrelay --skill constants-configuration-pattern",{"tool":38,"command":39},"bunx","bunx skills add CliqRelay\u002Fcliqrelay --skill constants-configuration-pattern",{"tool":41,"command":42},"pnpm","pnpm dlx skills add CliqRelay\u002Fcliqrelay --skill constants-configuration-pattern","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ffrontend\u002Fconstants-configuration-pattern\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M758WG0JG18W5MZD6ZPM6PGG","typst","Typst document creation and package development. Use when: (1) Working with .typ files, (2) User mentions typst, typst.toml, or typst-cli, (3) Creating or using Typst packages, (4) Developing document templates, (5) Converting Markdown\u002FLaTeX to Typst","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Ftypst\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M758WACKQMHG2BFF7T758J12","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", or \"switch to --preset\".","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M758W82G2QQ5Q14FKYNHRXQW","handoff","Compact the current conversation into a handoff document for another agent to pick up.","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M758W63H60EK55A93199B6NR","grilling","Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M758W4HD4PF66929V7MDGKW8","grill-me","A relentless interview to sharpen a plan or design.","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M758VYC5CCTP7EA5VKE7YWM5","dont-waffle","Use this skill when answering questions, explaining concepts, writing technical responses, reviewing code, or helping with development tasks. Communicate in clear, simple, standard English. Keep answers concise and focused, remove unnecessary filler and repetition, explain technical ideas in plain language, and structure information so it is easy to read and understand. When showing code, present it clearly with enough context for the developer to understand what it does and where it belongs.","https:\u002F\u002Fgithub.com\u002FCliqRelay\u002Fcliqrelay\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproductivity\u002Fdont-waffle\u002FSKILL.md",[],[]]