skills/integrations/fathom/fathom/SKILL.md
Complete Fathom integration skill. Load when user wants to fetch meetings, get transcripts, list recordings, or interact with Fathom meeting data. Supports filtering by attendee domain and extracting summaries/action items.
npx skillsauth add beam-ai-team/beam-next-skills fathomInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Complete Fathom API integration for meeting recordings and transcripts.
Provides full Fathom meeting interaction:
Get your API key from Fathom Settings → API
Add to .env:
FATHOM_API_KEY=your-api-key-here
python3 00-system/skills/fathom/fathom-master/scripts/fathom_client.py
Expected output:
Fathom client initialized successfully
Found X meetings
fathom/
├── SKILL.md # This file (main entry point)
├── credentials/
│ └── README.md # How to get your API key
├── fathom-connect/ # Connection setup skill
│ └── SKILL.md
└── fathom-master/ # Scripts and references
├── scripts/
│ ├── fathom_client.py # Shared API client (reusable)
│ ├── list_meetings.py # List meetings with filters
│ └── get_transcript.py # Get transcript by ID
└── references/
├── authentication.md # API key setup
├── api-reference.md # Endpoints and parameters
└── error-handling.md # Common errors and solutions
| Category | Operations | |----------|------------| | Meetings | list, filter by domain, filter by date range | | Transcripts | get full transcript, speaker attribution | | Summaries | AI-generated meeting summaries | | Action Items | extracted tasks with assignees |
# List all recent meetings
python3 fathom-master/scripts/list_meetings.py
# List meetings for a client domain
python3 fathom-master/scripts/list_meetings.py --domain smartly.io
# List meetings from last 7 days with summaries
python3 fathom-master/scripts/list_meetings.py --days 7 --verbose
# Get transcript for a specific recording
python3 fathom-master/scripts/get_transcript.py --recording-id abc123-def456
# Get transcript as JSON (for processing)
python3 fathom-master/scripts/get_transcript.py --recording-id abc123 --json
# Save transcript to file
python3 fathom-master/scripts/get_transcript.py --recording-id abc123 --output meeting.txt
| Client | Domain | |--------|--------| | Smartly | smartly.io | | Rivertrace | rivertrace.com | | Moverii | moverii.de | | Doula Givers | doulagivers.com |
Uses API Key authentication via X-Api-Key header. Keys don't expire but can be rotated in Fathom Settings → API.
| Error | Solution |
|-------|----------|
| FATHOM_API_KEY not found | Add key to .env file |
| 401 Unauthorized | API key is invalid - regenerate in Fathom |
| 403 Forbidden | API not enabled on your Fathom plan |
| 404 Not Found | Recording ID doesn't exist or still processing |
Version: 1.1 Integration: Fathom API Tested: Scripts verified working Owner: Hassaan Ahmed
testing
Audit registry.yaml against disk, validate SKILL.md frontmatter, find duplicates and orphans. Load when user says 'audit skills registry', 'validate beam-next-skills', 'registry drift', 'skills catalog audit', 'check registry yaml'.
tools
All Workable ATS operations — fetch JDs, search candidates, post assessments/reviews. Load when user says "fetch JD", "search workable", "push to workable", "post review", "rate candidate", "workable", "push assessment", "list jobs", or after interview-coach completes an evaluation. Replaces workable-fetch-jd and workable-push-assessment.
data-ai
Load when user mentions "tavily research", "market intelligence", "competitive research", "GTM research", or needs real-time market data for sales, marketing, or vertical strategy.
development
Shared resource library for Slack integration skills. DO NOT load directly - provides common references (setup, API docs, error handling, authentication) and scripts used by slack-connect and individual Slack skills.