[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B37M36PW6P3VMNA2GPR3FY":3,"skill-same:01M7B37M36PW6P3VMNA2GPR3FY":58},{"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":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7B37M36PW6P3VMNA2GPR3FY","vault-credentials",null,"Store and retrieve encrypted credentials using Supabase Vault. Use when implementing features that need secure credential storage such as API keys, OAuth tokens, or sensitive configuration. Triggers when adding credential storage to a feature, implementing OAuth flows, or storing user-provided secrets.","gethamster\u002Fskills","gethamster","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F215697643?v=4","01M7B2R6PGB3SDZZ71E0WE2S74","Hamster","01M7B2R6Q21HWJRXZZWB78BNDG",4,"MIT","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002F.experimental\u002Fvault-credentials\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vault-credentials\ndescription: \"Store and retrieve encrypted credentials using Supabase Vault. Use when implementing features that need secure credential storage such as API keys, OAuth tokens, or sensitive configuration. Triggers when adding credential storage to a feature, implementing OAuth flows, or storing user-provided secrets.\"\nversion: \"1.0.0\"\n---\n\n# Supabase Vault Credentials\n\nImplement secure credential storage using Supabase Vault. This pattern is **framework-agnostic** - it works with any TypeScript environment that uses the Supabase client.\n\n## Architecture\n\nCredentials are stored **at runtime** when users provide them (OAuth flows, API key submission). The pattern:\n\n1. Store secret in Vault → receive UUID reference\n2. Store UUID in table's `*_secret_id` column\n3. Never store actual credentials in regular tables\n\n**Key principle**: Verify access BEFORE acquiring admin client, return `null` on failure (graceful degradation).\n\n## Implementation Workflow\n\n### 1. Gather Context\n\nAsk the user:\n\n- What feature needs credential storage? (e.g., \"stripe\", \"github\", \"twilio\")\n- What type of credentials? (API key, OAuth tokens, etc.)\n- Which table will reference the secret?\n\n### 2. Add Table Column\n\nIn the schema file (`apps\u002Fweb\u002Fsupabase\u002Fschemas\u002FXX-feature.sql`):\n\n```sql\ncreate table if not exists public.my_feature (\n  id uuid primary key default gen_random_uuid(),\n  account_id uuid not null references public.accounts(id) on delete cascade,\n  -- Vault reference - stores UUID pointing to encrypted secret\n  credentials_secret_id uuid,\n  created_at timestamptz default now() not null\n);\n\ncomment on column public.my_feature.credentials_secret_id\n  is 'UUID reference to vault.secrets for encrypted credentials';\n```\n\n### 3. Create Vault Helper Functions\n\nAdd to schema file. See [references\u002Fsql-functions.md](references\u002Fsql-functions.md) for complete templates.\n\nRequired functions:\n\n- `store_[feature]_credentials(p_user_id, p_account_id, p_credential_data)` → returns UUID\n- `get_[feature]_credentials(p_secret_id)` → returns decrypted text\n- `delete_[feature]_credentials(p_secret_id)` → returns boolean\n\nGrant execute to `service_role` only.\n\n### 4. Core Pattern (Framework-Agnostic)\n\nThe vault pattern requires two Supabase clients:\n\n- **RLS client**: For access verification and table operations\n- **Admin client**: For vault operations (bypasses RLS)\n\n```typescript\nimport type { SupabaseClient } from '@supabase\u002Fsupabase-js';\n\n\u002F**\n * Store credentials in vault\n * Works with any Supabase client instance\n *\u002F\nasync function storeCredentials(\n  client: SupabaseClient,      \u002F\u002F RLS-enforced client\n  adminClient: SupabaseClient, \u002F\u002F Admin client for vault\n  credentialData: string,\n  userId: string,\n  accountId: string,\n): Promise\u003Cstring | null> {\n  \u002F\u002F 1. Verify access via RLS client FIRST\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return null;\n\n  \u002F\u002F 2. Store in vault via admin client\n  const { data: secretId, error } = await adminClient.rpc('store_feature_credentials', {\n    p_user_id: userId,\n    p_account_id: accountId,\n    p_credential_data: credentialData,\n  });\n  if (error) return null;\n\n  return secretId;\n}\n\n\u002F**\n * Retrieve decrypted credentials\n *\u002F\nasync function getCredentials(\n  client: SupabaseClient,\n  adminClient: SupabaseClient,\n  secretId: string,\n  accountId: string,\n): Promise\u003Cstring | null> {\n  \u002F\u002F Verify access first\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return null;\n\n  const { data, error } = await adminClient.rpc('get_feature_credentials', {\n    p_secret_id: secretId,\n  });\n  if (error) return null;\n\n  return data;\n}\n\n\u002F**\n * Delete credentials from vault\n *\u002F\nasync function deleteCredentials(\n  client: SupabaseClient,\n  adminClient: SupabaseClient,\n  secretId: string,\n  accountId: string,\n): Promise\u003Cboolean> {\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return false;\n\n  const { data, error } = await adminClient.rpc('delete_feature_credentials', {\n    p_secret_id: secretId,\n  });\n  if (error) return false;\n\n  return data ?? false;\n}\n```\n\n### 5. Usage Example\n\n```typescript\n\u002F\u002F Store credentials and save reference\nconst secretId = await storeCredentials(client, adminClient, apiKey, userId, accountId);\nif (!secretId) throw new Error('Failed to store credentials');\n\n\u002F\u002F Save UUID reference in table (NOT the actual credential)\nawait client.from('my_feature').insert({\n  account_id: accountId,\n  credentials_secret_id: secretId,\n});\n```\n\n### 6. Soft Delete Pattern\n\nWhen deleting records:\n\n1. Delete from vault first\n2. Clear `credentials_secret_id` reference\n3. Soft delete the record\n\n```typescript\nif (record.credentials_secret_id) {\n  await deleteCredentials(client, adminClient, record.credentials_secret_id, accountId);\n}\nawait softDelete(recordId);\n```\n\n## Client Separation Rule\n\n| Operation | Client Type | RLS |\n| --- | --- | --- |\n| Vault operations | Admin client | ❌ Manual auth required |\n| Table CRUD | RLS client | ✅ Enforced |\n| Access verification | RLS client | ✅ Uses `has_role_on_account` |\n\nHow to get these clients varies by framework - see [references\u002Frepository-pattern.md](references\u002Frepository-pattern.md) for Next.js and NestJS examples.\n\n## Existing Examples\n\nReference these implementations:\n\n- **SQL Functions**: `apps\u002Fweb\u002Fsupabase\u002Fschemas\u002F25-context-connections.sql`, `apps\u002Fweb\u002Fsupabase\u002Fschemas\u002F29-coding-agents.sql`\n- **NestJS Repository**: `apps\u002Fai\u002Fsrc\u002Fmodules\u002Fcoding-agent\u002Frepositories\u002Fagent-config.repository.ts`\n\n## Security Checklist\n\n- [ ] Vault functions use `security definer` with `set search_path = ''`\n- [ ] Only `service_role` has execute permissions on vault functions\n- [ ] Access verified via RLS client BEFORE acquiring admin client\n- [ ] Vault operations return `null`\u002F`false` on failure (graceful degradation)\n- [ ] Actual credentials never stored in regular table columns\n- [ ] Soft delete clears `credentials_secret_id` reference\n","# Supabase Vault Credentials\n\nImplement secure credential storage using Supabase Vault. This pattern is **framework-agnostic** - it works with any TypeScript environment that uses the Supabase client.\n\n## Architecture\n\nCredentials are stored **at runtime** when users provide them (OAuth flows, API key submission). The pattern:\n\n1. Store secret in Vault → receive UUID reference\n2. Store UUID in table's `*_secret_id` column\n3. Never store actual credentials in regular tables\n\n**Key principle**: Verify access BEFORE acquiring admin client, return `null` on failure (graceful degradation).\n\n## Implementation Workflow\n\n### 1. Gather Context\n\nAsk the user:\n\n- What feature needs credential storage? (e.g., \"stripe\", \"github\", \"twilio\")\n- What type of credentials? (API key, OAuth tokens, etc.)\n- Which table will reference the secret?\n\n### 2. Add Table Column\n\nIn the schema file (`apps\u002Fweb\u002Fsupabase\u002Fschemas\u002FXX-feature.sql`):\n\n```sql\ncreate table if not exists public.my_feature (\n  id uuid primary key default gen_random_uuid(),\n  account_id uuid not null references public.accounts(id) on delete cascade,\n  -- Vault reference - stores UUID pointing to encrypted secret\n  credentials_secret_id uuid,\n  created_at timestamptz default now() not null\n);\n\ncomment on column public.my_feature.credentials_secret_id\n  is 'UUID reference to vault.secrets for encrypted credentials';\n```\n\n### 3. Create Vault Helper Functions\n\nAdd to schema file. See [references\u002Fsql-functions.md](references\u002Fsql-functions.md) for complete templates.\n\nRequired functions:\n\n- `store_[feature]_credentials(p_user_id, p_account_id, p_credential_data)` → returns UUID\n- `get_[feature]_credentials(p_secret_id)` → returns decrypted text\n- `delete_[feature]_credentials(p_secret_id)` → returns boolean\n\nGrant execute to `service_role` only.\n\n### 4. Core Pattern (Framework-Agnostic)\n\nThe vault pattern requires two Supabase clients:\n\n- **RLS client**: For access verification and table operations\n- **Admin client**: For vault operations (bypasses RLS)\n\n```typescript\nimport type { SupabaseClient } from '@supabase\u002Fsupabase-js';\n\n\u002F**\n * Store credentials in vault\n * Works with any Supabase client instance\n *\u002F\nasync function storeCredentials(\n  client: SupabaseClient,      \u002F\u002F RLS-enforced client\n  adminClient: SupabaseClient, \u002F\u002F Admin client for vault\n  credentialData: string,\n  userId: string,\n  accountId: string,\n): Promise\u003Cstring | null> {\n  \u002F\u002F 1. Verify access via RLS client FIRST\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return null;\n\n  \u002F\u002F 2. Store in vault via admin client\n  const { data: secretId, error } = await adminClient.rpc('store_feature_credentials', {\n    p_user_id: userId,\n    p_account_id: accountId,\n    p_credential_data: credentialData,\n  });\n  if (error) return null;\n\n  return secretId;\n}\n\n\u002F**\n * Retrieve decrypted credentials\n *\u002F\nasync function getCredentials(\n  client: SupabaseClient,\n  adminClient: SupabaseClient,\n  secretId: string,\n  accountId: string,\n): Promise\u003Cstring | null> {\n  \u002F\u002F Verify access first\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return null;\n\n  const { data, error } = await adminClient.rpc('get_feature_credentials', {\n    p_secret_id: secretId,\n  });\n  if (error) return null;\n\n  return data;\n}\n\n\u002F**\n * Delete credentials from vault\n *\u002F\nasync function deleteCredentials(\n  client: SupabaseClient,\n  adminClient: SupabaseClient,\n  secretId: string,\n  accountId: string,\n): Promise\u003Cboolean> {\n  const { data: hasAccess } = await client.rpc('has_role_on_account', {\n    account_id: accountId,\n  });\n  if (!hasAccess) return false;\n\n  const { data, error } = await adminClient.rpc('delete_feature_credentials', {\n    p_secret_id: secretId,\n  });\n  if (error) return false;\n\n  return data ?? false;\n}\n```\n\n### 5. Usage Example\n\n```typescript\n\u002F\u002F Store credentials and save reference\nconst secretId = await storeCredentials(client, adminClient, apiKey, userId, accountId);\nif (!secretId) throw new Error('Failed to store credentials');\n\n\u002F\u002F Save UUID reference in table (NOT the actual credential)\nawait client.from('my_feature').insert({\n  account_id: accountId,\n  credentials_secret_id: secretId,\n});\n```\n\n### 6. Soft Delete Pattern\n\nWhen deleting records:\n\n1. Delete from vault first\n2. Clear `credentials_secret_id` reference\n3. Soft delete the record\n\n```typescript\nif (record.credentials_secret_id) {\n  await deleteCredentials(client, adminClient, record.credentials_secret_id, accountId);\n}\nawait softDelete(recordId);\n```\n\n## Client Separation Rule\n\n| Operation | Client Type | RLS |\n| --- | --- | --- |\n| Vault operations | Admin client | ❌ Manual auth required |\n| Table CRUD | RLS client | ✅ Enforced |\n| Access verification | RLS client | ✅ Uses `has_role_on_account` |\n\nHow to get these clients varies by framework - see [references\u002Frepository-pattern.md](references\u002Frepository-pattern.md) for Next.js and NestJS examples.\n\n## Existing Examples\n\nReference these implementations:\n\n- **SQL Functions**: `apps\u002Fweb\u002Fsupabase\u002Fschemas\u002F25-context-connections.sql`, `apps\u002Fweb\u002Fsupabase\u002Fschemas\u002F29-coding-agents.sql`\n- **NestJS Repository**: `apps\u002Fai\u002Fsrc\u002Fmodules\u002Fcoding-agent\u002Frepositories\u002Fagent-config.repository.ts`\n\n## Security Checklist\n\n- [ ] Vault functions use `security definer` with `set search_path = ''`\n- [ ] Only `service_role` has execute permissions on vault functions\n- [ ] Access verified via RLS client BEFORE acquiring admin client\n- [ ] Vault operations return `null`\u002F`false` on failure (graceful degradation)\n- [ ] Actual credentials never stored in regular table columns\n- [ ] Soft delete clears `credentials_secret_id` reference\n",{"name":5,"version":24,"description":7},"1.0.0","main","fe3bb1476c3ec23d8a366eac0fa8cd9f0852360a","skills\u002F.experimental\u002Fvault-credentials",0,"https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills","https:\u002F\u002Fgithub.com\u002Fgethamster","https:\u002F\u002Ftryhamster.com","We're building the AI-native future of work, unlocking the promised acceleration for your whole team, from idea to impact.","2026-11-05 11:33:33",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add gethamster\u002Fskills --skill vault-credentials",{"tool":40,"command":41},"bunx","bunx skills add gethamster\u002Fskills --skill vault-credentials",{"tool":43,"command":44},"pnpm","pnpm dlx skills add gethamster\u002Fskills --skill vault-credentials","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002F.experimental\u002Fvault-credentials\u002FSKILL.md",true,[48,54],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Frepository-pattern.md","REFERENCE","参考文档",7681,"https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002F.experimental\u002Fvault-credentials\u002Freferences\u002Frepository-pattern.md",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fsql-functions.md",3842,"https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002F.experimental\u002Fvault-credentials\u002Freferences\u002Fsql-functions.md",[59,66,73,80,87,94],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7B5MWYW0KE251276S56KQDZ","writing-waterfall-requirements-documents","Write a waterfall requirements document: elicit, structure and review testable, traceable requirements, then baseline the specification before design.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-waterfall-requirements-documents\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7B5MRCXWWPKREPB1CHQ7H90","writing-vision-and-values-statements","Write a V2MOM vision a reader can test and a ranked list of values that settles real tradeoffs, so the rest of the document has a clear anchor.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-vision-and-values-statements\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7B5MKH2CH22YZAHQW3080VQ","writing-system-prompts-for-claude","Write Claude prompts and CLAUDE.md files that supply exact inputs, scope the task, and define done so the first attempt can be checked.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-system-prompts-for-claude\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7B5ME1Y3X9RNRKP5HKHKACZ","writing-page-specific-website-copy","Website copywriting by page type: write homepage, landing page, pricing page and feature page copy that fits each page's visitor and single job.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-page-specific-website-copy\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7B5M8MQNM8MN8PYH6BVWJ2B","writing-internal-press-releases","How to write an internal press release: the one-page working backwards press release that opens a PR\u002FFAQ document before anything is built.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-internal-press-releases\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7B5M3P3YH1XF37R8PWXXSBK","writing-email-sequences-that-sell","Email sequence copywriting for nurture and sales: give each email one job, write clear subject lines, and close with one specific call to action.","https:\u002F\u002Fgithub.com\u002Fgethamster\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-email-sequences-that-sell\u002FSKILL.md",[],[]]