Agent skill

Fathom Common Errors

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Diagnose and fix Fathom API errors including auth failures and missing data.

MITAuto-check passedBackend & APIs

Install Fathom Common Errors

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill fathom-common-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace fathom-common-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/fathom-common-errors .claude/skills/fathom-common-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fathom-common-errors
GitHub stars
2.8k
Token cost
~772 tokens
SKILL.md length
279 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix Fathom API errors including auth failures and missing data.

  • Works in 6 steps: 401 Unauthorized → 429 Rate Limited → Empty Transcript → …
  • Transcripts are empty
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 6 more sections
  • Calls curl; reaches api.fathom.ai; needs FATHOM_API_KEY

What it does

Fathom Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix Fathom API errors including auth failures and missing data. Use when API calls fail, transcripts are empty, or webhooks are not firing. Trigger with phrases like "fathom error", "fathom not working", "fathom api failure", "fix fathom".

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

It sits in Backend & APIs, covering Webhooks. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Transcripts are empty
  • Webhooks are not firing
  • With phrases like fathom error
  • Fathom not working

Example prompts

  • “fathom error”
  • “fathom not working”
  • “fathom api failure”
  • “/fathom-common-errors”

Requirements

  • A credential in FATHOM_API_KEY
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Bash(curl:*), Grep

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 401 Unauthorized
  2. 429 Rate Limited
  3. Empty Transcript
  4. Missing Summary
  5. Webhook Not Firing
  6. OAuth Token Expired

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash(curl:*)
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.fathom.ai

    Also links to:

    • help.fathom.video
    • developers.fathom.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FATHOM_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Fathom Common Errors loads about 772 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 279 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~772

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 279 words, ~772 tokens.

Download SKILL.mdSave it as .claude/skills/fathom-common-errors/SKILL.md (or your agent's skills folder).
name
fathom-common-errors
description
Diagnose and fix Fathom API errors including auth failures and missing data. Use when API calls fail, transcripts are empty, or webhooks are not firing. Trigger with phrases like "fathom error", "fathom not working", "fathom api failure", "fix fathom".
allowed-tools
Read, Bash(curl:*), Grep
compatibility
Designed for Claude Code
version
1.6.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, meeting-intelligence, ai-notes, fathom

Fathom Common Errors

Overview

Diagnose Fathom meeting, transcript, integration, CRM-sync, and authorization issues with minimal redacted evidence and reversible fixes.

Prerequisites

  • A bounded non-sensitive reproduction, environment/version, consent/data policy, and approved diagnostic channel.

Instructions

  1. Identify affected meeting/action state and collect only opaque IDs, status, configuration version, and timing.
  2. Validate scope, access, consent, mapping, and rate-limit conditions before applying a correction.
  3. Test the smallest safe fix with synthetic records and document the verified result.

Output

  • A classified failure with redacted evidence, bounded remediation, owner, and verified recovery/escalation.

Error Handling

ConditionSafe response
Consent or access is unclearStop processing/sharing and verify ownership/policy.
CRM mapping is wrongPause sync and correct/test mapping before replay.
Duplicate action occursDeduplicate by stable ID; do not resend automatically.

Examples

For a missing follow-up, verify the synthetic meeting's action ID, consent state, mapping version, and CRM result in development. Escalate with redacted evidence if unresolved; do not inspect or share a customer recording to troubleshoot it.

Error Reference

1. 401 Unauthorized

Fix: Regenerate API key at Settings > Integrations > API Access.

2. 429 Rate Limited

Limit: 60 calls per minute across all API keys. Fix: Implement exponential backoff. Batch requests.

3. Empty Transcript

Causes: Meeting still processing, recording too short, or audio quality issues. Fix: Wait 5-10 minutes after recording. Check recording in Fathom UI.

4. Missing Summary

Cause: AI processing not complete. Fix: Poll the recording endpoint until summary is available.

5. Webhook Not Firing

Fix: Verify webhook URL in Settings > Integrations > Webhooks. Test with:

bash
curl -X POST https://your-url.com/webhooks/fathom \
  -H "Content-Type: application/json" \
  -d '{"type": "test"}'
6. OAuth Token Expired

Fix: Refresh the access token using your refresh token.

Quick Diagnostics

bash
# Test API key
curl -s -o /dev/null -w "%{http_code}" -H "X-Api-Key: ${FATHOM_API_KEY}" \
  https://api.fathom.ai/external/v1/meetings?limit=1

Resources

Next Steps

For diagnostics, see fathom-debug-bundle.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/.curated/fathom-common-errors of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Fathom Common Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fathom Common Errors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fathom Common Errors this skilljeremylongshore/tons-of-skills-marketplace2.8k—~772Automated safety check: PassMIT
Novu Design Workflownovuhq/novu40k—~2.6kAutomated safety check: PassCustom licence
Golivemikehasa/golive-skill1.2k—~13kAutomated safety check: NotesMIT
Stripe Appsfossasia/eventyay1.7k1 repos~3.6kAutomated safety check: PassApache-2.0
Dingtalk Messageagentscope-ai/ReMe3.6k—~1.6kAutomated safety check: PassApache-2.0
PR Review Provideryansongda/pay5.4k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.

    40k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Golive

    mikehasa/golive-skill

    Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).

    1.2k GitHub stars~13k tokensUpdated 5 days ago
    Backend & APIsAuto-check: notes
  • Stripe Apps

    fossasia/eventyay

    A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.

    1.7k GitHub starsUsed in 1 repo~3.6k tokens
    Backend & APIsAuto-check passed
  • Dingtalk Message

    agentscope-ai/ReMe

    钉钉消息发送技能。支持企业内部机器人(批量单聊/群聊)和 Webhook 自定义机器人两种接入方式,支持多机器人管理,支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。

    3.6k GitHub stars~1.6k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • PR Review Provider

    yansongda/pay

    A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.

    5.4k GitHub stars~2.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Stripe Best Practices

    kanchengw/cnllm

    Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…

    175 GitHub starsUsed in 2 repos~925 tokens
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Fathom Common Errors

What does Fathom Common Errors do?

Diagnose and fix Fathom API errors including auth failures and missing data. Fathom Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Diagnose and fix Fathom API errors including auth failures and missing data.

When should I use Fathom Common Errors?

Fathom Common Errors fits situations like: transcripts are empty; webhooks are not firing; with phrases like fathom error; fathom not working.

How do I install Fathom Common Errors in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill fathom-common-errors -a claude-code`. Or copy the skill folder (skills/.curated/fathom-common-errors in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/fathom-common-errors in your project. Claude Code loads it when a task matches its description.

How do I install Fathom Common Errors in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill fathom-common-errors -a codex`. Or copy the skill folder (skills/.curated/fathom-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/fathom-common-errors in your project. Codex loads it when a task matches its description.

Can I use Fathom Common Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill fathom-common-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fathom-common-errors, .gemini/skills/fathom-common-errors, .github/skills/fathom-common-errors and .opencode/skills/fathom-common-errors in your project.

What does Fathom Common Errors need to run?

Going by SKILL.md and its folder, Fathom Common Errors needs the command-line tools its instructions call (curl) and credentials named FATHOM_API_KEY. Our summary lists: A credential in FATHOM_API_KEY. Its frontmatter pre-approves these tools: Read, Bash(curl:*), Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Fathom Common Errors access the network?

SKILL.md names 3 domains. In commands or code: api.fathom.ai; the agent is likely to contact it when it follows the instructions. As links in the text: help.fathom.video and developers.fathom.ai. This is read from the text; nothing was executed.

Is Fathom Common Errors safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fathom Common Errors use?

Fathom Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fathom Common Errors use?

About 772 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fathom Common Errors?

Skills that share tags, products or a category with Fathom Common Errors: Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.2k stars), Stripe Apps (fossasia/eventyay, 1.7k stars) and Dingtalk Message (agentscope-ai/ReMe, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fathom Common Errors?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.