{"id":"b8c1ea66-ae9e-4727-9337-eb0c217e8077","shortId":"3gcUVD","kind":"skill","title":"gong","tagline":"Gong API for searching calls, transcripts, and conversation intelligence. Use when working with Gong call recordings, sales conversations, transcripts, meeting data, or conversation analytics. Supports listing calls, fetching transcripts, user management, and activity stats.","description":"# Gong\n\nAccess Gong conversation intelligence - calls, transcripts, users, and analytics.\n\n## Setup\n\nStore credentials in `~/.config/gong/credentials.json`:\n```json\n{\n  \"base_url\": \"https://us-XXXXX.api.gong.io\",\n  \"access_key\": \"YOUR_ACCESS_KEY\",\n  \"secret_key\": \"YOUR_SECRET_KEY\"\n}\n```\n\nGet credentials from Gong: Settings → Ecosystem → API → Create API Key.\n\n## Authentication\n\n```bash\nGONG_CREDS=~/.config/gong/credentials.json\nGONG_BASE=$(jq -r '.base_url' $GONG_CREDS)\nGONG_AUTH=$(jq -r '\"\\(.access_key):\\(.secret_key)\"' $GONG_CREDS | base64)\n\ncurl -s \"$GONG_BASE/v2/endpoint\" \\\n  -H \"Authorization: Basic $GONG_AUTH\" \\\n  -H \"Content-Type: application/json\"\n```\n\n## Safety Boundaries\n\n- Do not print raw access keys, secret keys, or full Authorization headers in chat output.\n- Do not call Gong endpoints other than the configured tenant base URL.\n- Do not export full transcripts or account data unless the user asked for that exact scope.\n- Do not persist Gong credentials anywhere outside the documented local config file.\n\n## Core Operations\n\n### List Users\n```bash\ncurl -s \"$GONG_BASE/v2/users\" -H \"Authorization: Basic $GONG_AUTH\" | \\\n  jq '[.users[] | {id, email: .emailAddress, name: \"\\(.firstName) \\(.lastName)\"}]'\n```\n\n### List Calls (with date range)\n```bash\ncurl -s -X POST \"$GONG_BASE/v2/calls/extensive\" \\\n  -H \"Authorization: Basic $GONG_AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter\": {\n      \"fromDateTime\": \"2025-01-01T00:00:00Z\",\n      \"toDateTime\": \"2025-01-31T23:59:59Z\"\n    },\n    \"contentSelector\": {}\n  }' | jq '{\n    total: .records.totalRecords,\n    calls: [.calls[] | {\n      id: .metaData.id,\n      title: .metaData.title,\n      started: .metaData.started,\n      duration_min: ((.metaData.duration // 0) / 60 | floor),\n      url: .metaData.url\n    }]\n  }'\n```\n\n### Get Call Transcript\n```bash\ncurl -s -X POST \"$GONG_BASE/v2/calls/transcript\" \\\n  -H \"Authorization: Basic $GONG_AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"filter\": {\"callIds\": [\"CALL_ID\"]}}' | \\\n  jq '.callTranscripts[0].transcript[] | \"\\(.speakerName // \"Speaker\"): \\(.sentences[].text)\"' -r\n```\n\n### Get Call Details\n```bash\ncurl -s -X POST \"$GONG_BASE/v2/calls/extensive\" \\\n  -H \"Authorization: Basic $GONG_AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter\": {\"callIds\": [\"CALL_ID\"]},\n    \"contentSelector\": {\"exposedFields\": {\"content\": true, \"parties\": true}}\n  }' | jq '.calls[0]'\n```\n\n### Activity Stats\n```bash\ncurl -s -X POST \"$GONG_BASE/v2/stats/activity/aggregate\" \\\n  -H \"Authorization: Basic $GONG_AUTH\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter\": {\n      \"fromDateTime\": \"2025-01-01T00:00:00Z\",\n      \"toDateTime\": \"2025-01-31T23:59:59Z\"\n    }\n  }'\n```\n\n## Endpoints Reference\n\n| Endpoint | Method | Use |\n|----------|--------|-----|\n| `/v2/users` | GET | List users |\n| `/v2/calls/extensive` | POST | List/filter calls |\n| `/v2/calls/transcript` | POST | Get transcripts |\n| `/v2/stats/activity/aggregate` | POST | Activity stats |\n| `/v2/meetings` | GET | Scheduled meetings |\n\n## Pagination\n\nResponses include cursor for pagination:\n```json\n{\"records\": {\"totalRecords\": 233, \"cursor\": \"eyJ...\"}}\n```\n\nInclude cursor in next request: `{\"cursor\": \"eyJ...\"}`\n\n## Date Helpers\n\n```bash\n# Last 7 days\nFROM=$(date -v-7d +%Y-%m-%dT00:00:00Z 2>/dev/null || date -d \"7 days ago\" +%Y-%m-%dT00:00:00Z)\nTO=$(date +%Y-%m-%dT23:59:59Z)\n```\n\n## Notes\n\n- Rate limit: ~3 requests/second\n- Call IDs are large integers as strings\n- Transcripts may take time to process after call ends\n- Date format: ISO 8601 (e.g., `2025-01-15T00:00:00Z`)","tags":["gong","agent","skills","jdrhyne","agent-skills","agentic-ai","ai-agents","automation","claude-code","clawdbot","codex","cursor"],"capabilities":["skill","source-jdrhyne","skill-gong","topic-agent-skills","topic-agentic-ai","topic-ai-agents","topic-automation","topic-claude-code","topic-clawdbot","topic-codex","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-github-copilot","topic-llm-agents"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jdrhyne/agent-skills/gong","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jdrhyne/agent-skills","source_repo":"https://github.com/jdrhyne/agent-skills","install_from":"skills.sh"}},"qualityScore":"0.565","qualityRationale":"deterministic score 0.56 from registry signals: · indexed on github topic:agent-skills · 230 github stars · SKILL.md body (3,609 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:54:19.049Z","embedding":null,"createdAt":"2026-04-18T22:04:57.620Z","updatedAt":"2026-04-22T00:54:19.049Z","lastSeenAt":"2026-04-22T00:54:19.049Z","tsv":"'-01':218,219,225,341,342,348,459 '-15':460 '-31':226,349 '/.config/gong/credentials.json':50,79 '/dev/null':414 '/v2/calls/extensive':362 '/v2/calls/transcript':366 '/v2/meetings':374 '/v2/stats/activity/aggregate':370 '/v2/users':358 '0':245,277,317 '00':221,344,411,423,462 '00z':222,345,412,424,463 '2':413 '2025':217,224,340,347,458 '233':387 '3':435 '59':228,351,430 '59z':229,352,431 '60':246 '7':401,417 '7d':407 '8601':456 'access':37,55,58,92,119 'account':148 'activ':34,318,372 'ago':419 'analyt':25,45 'anywher':163 'api':3,71,73 'application/json':112,213,269,303,336 'ask':153 'auth':89,107,183,208,264,298,331 'authent':75 'author':104,125,180,205,261,295,328 'base':52,81,84,140 'base/v2/calls/extensive':203,293 'base/v2/calls/transcript':259 'base/v2/endpoint':102 'base/v2/stats/activity/aggregate':326 'base/v2/users':178 'base64':98 'bash':76,174,197,253,287,320,399 'basic':105,181,206,262,296,329 'boundari':114 'call':6,16,28,41,132,193,234,235,251,273,285,307,316,365,437,451 'callid':272,306 'calltranscript':276 'chat':128 'config':168 'configur':138 'content':110,211,267,301,311,334 'content-typ':109,210,266,300,333 'contentselector':230,309 'convers':9,19,24,39 'core':170 'creat':72 'cred':78,87,97 'credenti':48,66,162 'curl':99,175,198,254,288,321 'cursor':381,388,391,395 'd':214,270,304,337,416 'data':22,149 'date':195,397,404,415,426,453 'day':402,418 'detail':286 'document':166 'dt00':410,422 'dt23':429 'durat':242 'e.g':457 'ecosystem':70 'email':187 'emailaddress':188 'end':452 'endpoint':134,353,355 'exact':156 'export':144 'exposedfield':310 'eyj':389,396 'fetch':29 'file':169 'filter':215,271,305,338 'firstnam':190 'floor':247 'format':454 'fromdatetim':216,339 'full':124,145 'get':65,250,284,359,368,375 'gong':1,2,15,36,38,68,77,80,86,88,96,101,106,133,161,177,182,202,207,258,263,292,297,325,330 'h':103,108,179,204,209,260,265,294,299,327,332 'header':126 'helper':398 'id':186,236,274,308,438 'includ':380,390 'integ':441 'intellig':10,40 'iso':455 'jq':82,90,184,231,275,315 'json':51,384 'key':56,59,61,64,74,93,95,120,122 'larg':440 'last':400 'lastnam':191 'limit':434 'list':27,172,192,360 'list/filter':364 'local':167 'm':409,421,428 'manag':32 'may':445 'meet':21,377 'metadata.duration':244 'metadata.id':237 'metadata.started':241 'metadata.title':239 'metadata.url':249 'method':356 'min':243 'name':189 'next':393 'note':432 'oper':171 'output':129 'outsid':164 'pagin':378,383 'parti':313 'persist':160 'post':201,257,291,324,363,367,371 'print':117 'process':449 'r':83,91,283 'rang':196 'rate':433 'raw':118 'record':17,385 'records.totalrecords':233 'refer':354 'request':394 'requests/second':436 'respons':379 'safeti':113 'sale':18 'schedul':376 'scope':157 'search':5 'secret':60,63,94,121 'sentenc':281 'set':69 'setup':46 'skill' 'skill-gong' 'source-jdrhyne' 'speaker':280 'speakernam':279 'start':240 'stat':35,319,373 'store':47 'string':443 'support':26 't00':220,343,461 't23':227,350 'take':446 'tenant':139 'text':282 'time':447 'titl':238 'todatetim':223,346 'topic-agent-skills' 'topic-agentic-ai' 'topic-ai-agents' 'topic-automation' 'topic-claude-code' 'topic-clawdbot' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-github-copilot' 'topic-llm-agents' 'total':232 'totalrecord':386 'transcript':7,20,30,42,146,252,278,369,444 'true':312,314 'type':111,212,268,302,335 'unless':150 'url':53,85,141,248 'us-xxxxx.api.gong.io':54 'use':11,357 'user':31,43,152,173,185,361 'v':406 'v-7d':405 'work':13 'x':200,256,290,323 'y':408,420,427","prices":[{"id":"61a201c8-8c7f-4a09-b4f5-29619924e0dc","listingId":"b8c1ea66-ae9e-4727-9337-eb0c217e8077","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jdrhyne","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:04:57.620Z"}],"sources":[{"listingId":"b8c1ea66-ae9e-4727-9337-eb0c217e8077","source":"github","sourceId":"jdrhyne/agent-skills/gong","sourceUrl":"https://github.com/jdrhyne/agent-skills/tree/main/skills/gong","isPrimary":false,"firstSeenAt":"2026-04-18T22:04:57.620Z","lastSeenAt":"2026-04-22T00:54:19.049Z"}],"details":{"listingId":"b8c1ea66-ae9e-4727-9337-eb0c217e8077","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jdrhyne","slug":"gong","github":{"repo":"jdrhyne/agent-skills","stars":230,"topics":["agent-skills","agentic-ai","ai-agents","automation","claude-code","clawdbot","codex","cursor","developer-tools","gemini-cli","github-copilot","llm-agents","mcp","openclaw","prompt-engineering","prompts"],"license":null,"html_url":"https://github.com/jdrhyne/agent-skills","pushed_at":"2026-03-27T14:29:53Z","description":"A collection of AI agent skills for Clawdbot, Claude Code, Codex","skill_md_sha":"5e7e06906b5886fda9b0140007f48deb66fcb3e8","skill_md_path":"skills/gong/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jdrhyne/agent-skills/tree/main/skills/gong"},"layout":"multi","source":"github","category":"agent-skills","frontmatter":{"name":"gong","description":"Gong API for searching calls, transcripts, and conversation intelligence. Use when working with Gong call recordings, sales conversations, transcripts, meeting data, or conversation analytics. Supports listing calls, fetching transcripts, user management, and activity stats."},"skills_sh_url":"https://skills.sh/jdrhyne/agent-skills/gong"},"updatedAt":"2026-04-22T00:54:19.049Z"}}