Imported from gabrielmoreira/agent-skills-mirror (
mirrors/repos/jeremylongshore@tons-of-skills-marketplace/skills/.curated/fathom-local-dev-loop/SKILL.md). Install upstream withnpx skills add gabrielmoreira/agent-skills-mirror --skill fathom-local-dev-loop. Copyright stays with the author (MIT).
Fathom Local Dev Loop
Overview
Use Fathom integrations in the normal local development loop: narrow change, synthetic validation, review, focused tests, and reversible commit.
Prerequisites
- A clean or recoverable branch, development credential, synthetic meeting/CRM fixtures, repository rules, and test commands.
Instructions
- Make one scoped integration/configuration change using development-only data and identity.
- Inspect the diff, run focused mock/unit checks, and execute a bounded synthetic workflow test.
- Commit reviewed changes separately and promote only through normal protected workflow.
Output
- A small reviewed change with test evidence and a normal rollback path, without production meeting or contact data.
Error Handling
| Condition | Safe response |
|---|---|
| Synthetic test exposes real data | Stop, restrict access, and follow the data procedure. |
| CRM mapping/test fails | Revert or correct within scope; do not use production records to diagnose. |
| Working tree is mixed | Separate unrelated changes before committing. |
Examples
Update one mapping using a synthetic meeting/action, run its focused test, inspect the redacted result, and commit it separately. If the test fails or unrelated files change, revert/split the work rather than disabling checks or pointing local tooling at production.
Project Structure
fathom-integration/
├── src/
│ ├── fathom_client.py
│ ├── transcript_processor.py
│ └── webhook_handler.py
├── tests/
│ ├── fixtures/
│ │ ├── meeting.json
│ │ └── transcript.json
│ └── test_processor.py
├── .env.local
└── requirements.txt
Mock Meeting Data
MOCK_MEETING = {
"id": "mtg-123",
"title": "Product Review Q1",
"created_at": "2026-03-20T14:00:00Z",
"duration_seconds": 1800,
"participants": ["alice@example.com", "bob@example.com"],
"summary": "Discussed Q1 roadmap priorities. Agreed to focus on API improvements.",
"action_items": [
{"text": "Alice to draft API spec by Friday", "assignee": "alice@example.com"},
{"text": "Bob to review competitor analysis", "assignee": "bob@example.com"}
]
}
MOCK_TRANSCRIPT = {
"segments": [
{"speaker": "Alice", "text": "Let us review the Q1 priorities.", "start_time": 0.0},
{"speaker": "Bob", "text": "I think the API work should come first.", "start_time": 5.2},
]
}Development Script
# Run with mock data (no API calls)
FATHOM_MOCK=true python3 src/transcript_processor.py
# Run with real API
python3 src/transcript_processor.pyResources
Next Steps
See fathom-sdk-patterns for production API wrappers.