--- name: fathom-cost-tuning-d2a783bb77fd description: 'Optimize Fathom API usage and plan selection. Trigger with phrases like "fathom cost", "fathom pricing", "fathom plan". ' allowed-tools: Read, Grep version: 1.6.0 license: MIT author: Jeremy Longshore tags: - saas - meeting-intelligence - ai-notes - fathom compatibility: Designed for Claude Code --- # Fathom Cost Tuning ## Prerequisites - An aggregate usage/cost baseline, budget owner, recording/consent policy, quality/delivery SLO, and synthetic evaluation fixture. ## Instructions 1. Measure aggregate meeting volume, processing, sync/follow-up behavior, errors, and cost by approved scope. 2. Change one reversible setting and compare against the baseline and consent/delivery safeguards. 3. Retain the change only after owner approval; restore the prior setting on regression. ## Output - A measured cost decision with owner, data/consent/delivery guardrails, and rollback threshold. ## Examples Evaluate a development workflow with synthetic meeting metadata, reduce duplicate processing or unnecessary integration calls, and compare aggregate cost/latency/error metrics. Revert on quality, consent, or CRM-sync regression; do not disable audit, retention, or access controls to save cost. ## Overview Fathom pricing scales with per-seat licensing for team features, with primary cost drivers being transcript storage volume and recording hours consumed. Every meeting generates a transcript and AI summary that persist in storage. For organizations running dozens of meetings daily, unchecked transcript accumulation and redundant API polling for meeting data create unnecessary spend. Optimizing retrieval patterns and storage lifecycle directly reduces both API costs and plan overhead. ## Cost Breakdown | Component | Cost Driver | Optimization | |-----------|------------|--------------| | Seat licenses | Per-user/month for Team plan | Audit active seats quarterly; remove inactive users | | Transcript storage | Accumulated meeting transcripts | Archive transcripts older than 90 days to local storage | | Recording hours | Meeting duration across all users | Disable recording for standup/informal meetings | | API polling | Repeated list/get calls for meeting data | Use webhooks for push notifications instead of polling | | CRM sync events | Per-meeting sync to Salesforce/HubSpot | Batch CRM writes; skip internal-only meetings | ## API Call Reduction ```typescript class FathomTranscriptCache { private cache = new Map(); async getTranscript(meetingId: string, apiFn: () => Promise): Promise { // Transcripts are immutable after generation — cache permanently if (this.cache.has(meetingId)) return this.cache.get(meetingId); const result = await apiFn(); this.cache.set(meetingId, result); return result; } async listMeetings(params: { include_summary: boolean }): Promise { // Always use include_summary=true to avoid N+1 calls // Fetches summaries inline with the list response const response = await fetch('/api/meetings?include_summary=true'); return response.json(); } } ``` ## Usage Monitoring ```typescript class FathomUsageTracker { private apiCalls = 0; private readonly rateLimit = 60; // 60 req/min private windowStart = Date.now(); async throttledCall(fn: () => Promise): Promise { if (Date.now() - this.windowStart > 60_000) { this.apiCalls = 0; this.windowStart = Date.now(); } if (this.apiCalls >= this.rateLimit) { const waitMs = 60_000 - (Date.now() - this.windowStart); await new Promise(r => setTimeout(r, waitMs)); this.apiCalls = 0; this.windowStart = Date.now(); } this.apiCalls++; return fn(); } getUsageReport(): { callsThisMinute: number; remainingCapacity: number } { return { callsThisMinute: this.apiCalls, remainingCapacity: this.rateLimit - this.apiCalls }; } } ``` ## Cost Optimization Checklist - [ ] Use webhooks for meeting completion events instead of polling - [ ] Always pass `include_summary=true` in list requests to avoid extra calls - [ ] Cache transcripts permanently — they never change after generation - [ ] Batch API processing within the 60 req/min rate limit - [ ] Audit team seats quarterly and remove inactive users - [ ] Archive transcripts older than 90 days to reduce storage costs - [ ] Disable auto-recording for informal or standup meetings - [ ] Skip CRM sync for internal-only meetings ## Error Handling | Issue | Cause | Fix | |-------|-------|-----| | 429 rate limit hit | Exceeding 60 req/min | Implement throttling with sliding window | | Duplicate transcript fetches | Multiple services requesting same meeting | Centralize through shared cache | | Stale meeting list | Polling on long intervals | Switch to webhook-driven updates | | CRM sync failures | Batch too large or network timeout | Chunk CRM writes into batches of 10 | | Storage costs climbing | No transcript lifecycle policy | Implement 90-day archive-to-local policy | ## Resources - [Fathom Pricing](https://fathom.video/pricing) - [Fathom API Documentation](https://docs.fathom.video) ## Next Steps See `fathom-performance-tuning`. --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/fathom-pack/skills/fathom-cost-tuning/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2025 Jeremy Longshore Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/saas-packs/fathom-pack/skills/fathom-cost-tuning/SKILL.md Attribution basis: Source repository record Fields of work: Marketing Roles: Growth Marketer, Marketing Analyst, Product Marketer Specialties: API Tools: Fathom Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: ec10743a07548a5a897a0d26728d50981af5069a1bfef6c286d12f4e360f2512