[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78ZXD61D36PCN67619T0CDW":3,"skill-same:01M78ZXD61D36PCN67619T0CDW":57},{"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":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M78ZXD61D36PCN67619T0CDW","fathom-upgrade-migration",null,"Handle Fathom API changes and version migrations.\nTrigger with phrases like \"upgrade fathom\", \"fathom api changes\", \"fathom migration\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--fathom-pack--fathom-upgrade-migration\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: fathom-upgrade-migration\ndescription: |\n  Handle Fathom API changes and version migrations.\n  Trigger with phrases like \"upgrade fathom\", \"fathom api changes\", \"fathom migration\".\nallowed-tools: Read, Write, Edit, Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, meeting-intelligence, ai-notes, fathom]\ncompatible-with: claude-code\n---\n\n# Fathom Upgrade & Migration\n\n## Overview\n\nFathom is an AI meeting assistant that records, transcribes, and summarizes meetings. The API operates under `\u002Fexternal\u002Fv1` and exposes endpoints for meetings, transcripts, and action items. Tracking API changes is important because Fathom iterates rapidly on transcript schema fields (speaker attribution, sentiment data, highlight clips) and breaking changes to response shapes can silently corrupt downstream integrations that consume meeting data for CRM sync or analytics pipelines.\n\n## Version Detection\n\n```typescript\nconst FATHOM_BASE = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\";\n\ninterface FathomVersionCheck {\n  apiVersion: string;\n  knownFields: string[];\n  detectedFields: string[];\n  newFields: string[];\n  removedFields: string[];\n}\n\nasync function detectFathomApiChanges(apiKey: string): Promise\u003CFathomVersionCheck> {\n  const res = await fetch(`${FATHOM_BASE}\u002Fmeetings?limit=1`, {\n    headers: { Authorization: `Bearer ${apiKey}` },\n  });\n  const data = await res.json();\n  const knownFields = [\"id\", \"title\", \"created_at\", \"duration\", \"attendees\", \"transcript_url\"];\n  const detectedFields = data.meetings?.[0] ? Object.keys(data.meetings[0]) : [];\n  return {\n    apiVersion: res.headers.get(\"x-api-version\") ?? \"v1\",\n    knownFields,\n    detectedFields,\n    newFields: detectedFields.filter((f) => !knownFields.includes(f)),\n    removedFields: knownFields.filter((f) => !detectedFields.includes(f)),\n  };\n}\n```\n\n## Migration Checklist\n\n- [ ] Review Fathom product updates for API changes and deprecations\n- [ ] Audit all endpoints referencing `\u002Fexternal\u002Fv1` in codebase\n- [ ] Verify meeting list response schema matches current field expectations\n- [ ] Check transcript endpoint for new speaker attribution fields\n- [ ] Validate action item extraction format (structured vs. plain text)\n- [ ] Update OAuth token refresh flow if auth endpoints changed\n- [ ] Test webhook payloads for meeting completion events\n- [ ] Verify pagination parameters (`cursor` vs. `offset`) are current\n- [ ] Update CRM sync mappings if meeting metadata fields renamed\n- [ ] Run integration tests against Fathom sandbox environment\n\n## Schema Migration\n\n```typescript\n\u002F\u002F Fathom transcript response evolved: flat text → speaker-attributed segments\ninterface OldTranscript {\n  meeting_id: string;\n  text: string;\n  created_at: string;\n}\n\ninterface NewTranscript {\n  meeting_id: string;\n  segments: Array\u003C{\n    speaker: string;\n    text: string;\n    start_time: number;\n    end_time: number;\n    confidence: number;\n  }>;\n  summary: string;\n  action_items: Array\u003C{ text: string; assignee?: string }>;\n  created_at: string;\n}\n\nfunction migrateTranscript(old: OldTranscript): NewTranscript {\n  return {\n    meeting_id: old.meeting_id,\n    segments: [{ speaker: \"Unknown\", text: old.text, start_time: 0, end_time: 0, confidence: 1.0 }],\n    summary: \"\",\n    action_items: [],\n    created_at: old.created_at,\n  };\n}\n```\n\n## Rollback Strategy\n\n```typescript\nclass FathomClient {\n  private baseUrl: string;\n  private fallbackUrl: string;\n\n  constructor(private apiKey: string) {\n    this.baseUrl = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\";\n    this.fallbackUrl = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\"; \u002F\u002F same base, version in path\n  }\n\n  async getMeetings(limit = 20): Promise\u003Cany> {\n    try {\n      const res = await fetch(`${this.baseUrl}\u002Fmeetings?limit=${limit}`, {\n        headers: { Authorization: `Bearer ${this.apiKey}` },\n      });\n      if (!res.ok) throw new Error(`Fathom API ${res.status}`);\n      return await res.json();\n    } catch (err) {\n      console.warn(\"Primary endpoint failed, attempting fallback:\", err);\n      const res = await fetch(`${this.fallbackUrl}\u002Fmeetings?limit=${limit}`, {\n        headers: { Authorization: `Bearer ${this.apiKey}`, Accept: \"application\u002Fjson; version=legacy\" },\n      });\n      return await res.json();\n    }\n  }\n}\n```\n\n## Error Handling\n\n| Migration Issue | Symptom | Fix |\n|----------------|---------|-----|\n| Transcript schema changed | Missing `segments` array, only flat `text` returned | Update parser to handle both old flat and new segmented formats |\n| Webhook payload mismatch | `meeting.completed` event missing expected fields | Re-register webhook with updated event schema version |\n| OAuth scope expansion | `403 Forbidden` on transcript endpoint | Re-authorize with updated scopes (`meetings.read`, `transcripts.read`) |\n| Pagination cursor invalid | `400 Bad Request` with cursor token | Switch from offset-based to cursor-based pagination if API changed |\n| Rate limit headers changed | `429` without `Retry-After` header | Implement exponential backoff instead of relying on header |\n\n## Resources\n\n- [Fathom Product Updates](https:\u002F\u002Fhelp.fathom.video\u002Fen\u002Farticles\u002F6220097)\n- [Fathom API Documentation](https:\u002F\u002Ffathom.video\u002Fapi)\n\n## Next Steps\n\nFor CI pipeline integration, see `fathom-ci-integration`.\n","# Fathom Upgrade & Migration\n\n## Overview\n\nFathom is an AI meeting assistant that records, transcribes, and summarizes meetings. The API operates under `\u002Fexternal\u002Fv1` and exposes endpoints for meetings, transcripts, and action items. Tracking API changes is important because Fathom iterates rapidly on transcript schema fields (speaker attribution, sentiment data, highlight clips) and breaking changes to response shapes can silently corrupt downstream integrations that consume meeting data for CRM sync or analytics pipelines.\n\n## Version Detection\n\n```typescript\nconst FATHOM_BASE = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\";\n\ninterface FathomVersionCheck {\n  apiVersion: string;\n  knownFields: string[];\n  detectedFields: string[];\n  newFields: string[];\n  removedFields: string[];\n}\n\nasync function detectFathomApiChanges(apiKey: string): Promise\u003CFathomVersionCheck> {\n  const res = await fetch(`${FATHOM_BASE}\u002Fmeetings?limit=1`, {\n    headers: { Authorization: `Bearer ${apiKey}` },\n  });\n  const data = await res.json();\n  const knownFields = [\"id\", \"title\", \"created_at\", \"duration\", \"attendees\", \"transcript_url\"];\n  const detectedFields = data.meetings?.[0] ? Object.keys(data.meetings[0]) : [];\n  return {\n    apiVersion: res.headers.get(\"x-api-version\") ?? \"v1\",\n    knownFields,\n    detectedFields,\n    newFields: detectedFields.filter((f) => !knownFields.includes(f)),\n    removedFields: knownFields.filter((f) => !detectedFields.includes(f)),\n  };\n}\n```\n\n## Migration Checklist\n\n- [ ] Review Fathom product updates for API changes and deprecations\n- [ ] Audit all endpoints referencing `\u002Fexternal\u002Fv1` in codebase\n- [ ] Verify meeting list response schema matches current field expectations\n- [ ] Check transcript endpoint for new speaker attribution fields\n- [ ] Validate action item extraction format (structured vs. plain text)\n- [ ] Update OAuth token refresh flow if auth endpoints changed\n- [ ] Test webhook payloads for meeting completion events\n- [ ] Verify pagination parameters (`cursor` vs. `offset`) are current\n- [ ] Update CRM sync mappings if meeting metadata fields renamed\n- [ ] Run integration tests against Fathom sandbox environment\n\n## Schema Migration\n\n```typescript\n\u002F\u002F Fathom transcript response evolved: flat text → speaker-attributed segments\ninterface OldTranscript {\n  meeting_id: string;\n  text: string;\n  created_at: string;\n}\n\ninterface NewTranscript {\n  meeting_id: string;\n  segments: Array\u003C{\n    speaker: string;\n    text: string;\n    start_time: number;\n    end_time: number;\n    confidence: number;\n  }>;\n  summary: string;\n  action_items: Array\u003C{ text: string; assignee?: string }>;\n  created_at: string;\n}\n\nfunction migrateTranscript(old: OldTranscript): NewTranscript {\n  return {\n    meeting_id: old.meeting_id,\n    segments: [{ speaker: \"Unknown\", text: old.text, start_time: 0, end_time: 0, confidence: 1.0 }],\n    summary: \"\",\n    action_items: [],\n    created_at: old.created_at,\n  };\n}\n```\n\n## Rollback Strategy\n\n```typescript\nclass FathomClient {\n  private baseUrl: string;\n  private fallbackUrl: string;\n\n  constructor(private apiKey: string) {\n    this.baseUrl = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\";\n    this.fallbackUrl = \"https:\u002F\u002Fapi.fathom.video\u002Fexternal\u002Fv1\"; \u002F\u002F same base, version in path\n  }\n\n  async getMeetings(limit = 20): Promise\u003Cany> {\n    try {\n      const res = await fetch(`${this.baseUrl}\u002Fmeetings?limit=${limit}`, {\n        headers: { Authorization: `Bearer ${this.apiKey}` },\n      });\n      if (!res.ok) throw new Error(`Fathom API ${res.status}`);\n      return await res.json();\n    } catch (err) {\n      console.warn(\"Primary endpoint failed, attempting fallback:\", err);\n      const res = await fetch(`${this.fallbackUrl}\u002Fmeetings?limit=${limit}`, {\n        headers: { Authorization: `Bearer ${this.apiKey}`, Accept: \"application\u002Fjson; version=legacy\" },\n      });\n      return await res.json();\n    }\n  }\n}\n```\n\n## Error Handling\n\n| Migration Issue | Symptom | Fix |\n|----------------|---------|-----|\n| Transcript schema changed | Missing `segments` array, only flat `text` returned | Update parser to handle both old flat and new segmented formats |\n| Webhook payload mismatch | `meeting.completed` event missing expected fields | Re-register webhook with updated event schema version |\n| OAuth scope expansion | `403 Forbidden` on transcript endpoint | Re-authorize with updated scopes (`meetings.read`, `transcripts.read`) |\n| Pagination cursor invalid | `400 Bad Request` with cursor token | Switch from offset-based to cursor-based pagination if API changed |\n| Rate limit headers changed | `429` without `Retry-After` header | Implement exponential backoff instead of relying on header |\n\n## Resources\n\n- [Fathom Product Updates](https:\u002F\u002Fhelp.fathom.video\u002Fen\u002Farticles\u002F6220097)\n- [Fathom API Documentation](https:\u002F\u002Ffathom.video\u002Fapi)\n\n## Next Steps\n\nFor CI pipeline integration, see `fathom-ci-integration`.\n",{"name":5,"tags":24,"author":29,"license":15,"version":30,"description":31,"allowed-tools":32,"compatible-with":33},[25,26,27,28],"saas","meeting-intelligence","ai-notes","fathom","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Handle Fathom API changes and version migrations.\nTrigger with phrases like \"upgrade fathom\", \"fathom api changes\", \"fathom migration\".\n","Read, Write, Edit, Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--fathom-pack--fathom-upgrade-migration",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill fathom-upgrade-migration",{"tool":49,"command":50},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill fathom-upgrade-migration",{"tool":52,"command":53},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill fathom-upgrade-migration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--fathom-pack--fathom-upgrade-migration\u002FSKILL.md",true,[],[58,65,72,79,86,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\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},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]