{"id":"ef69e94c-3cb8-439a-a636-ba49498af937","shortId":"vde8A7","kind":"skill","title":"convertkit-automation","tagline":"Automate ConvertKit (Kit) tasks via Rube MCP (Composio): manage subscribers, tags, broadcasts, and broadcast stats. Always search tools first for current schemas.","description":"# ConvertKit (Kit) Automation via Rube MCP\n\nAutomate ConvertKit (now known as Kit) email marketing operations through Composio's Kit toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Kit connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `kit`\n3. If connection is not ACTIVE, follow the returned auth link to complete Kit authentication\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. List and Search Subscribers\n\n**When to use**: User wants to browse, search, or filter email subscribers\n\n**Tool sequence**:\n1. `KIT_LIST_SUBSCRIBERS` - List subscribers with filters and pagination [Required]\n\n**Key parameters**:\n- `status`: Filter by status ('active' or 'inactive')\n- `email_address`: Exact email to search for\n- `created_after`/`created_before`: Date range filter (YYYY-MM-DD)\n- `updated_after`/`updated_before`: Date range filter (YYYY-MM-DD)\n- `sort_field`: Sort by 'id', 'cancelled_at', or 'updated_at'\n- `sort_order`: 'asc' or 'desc'\n- `per_page`: Results per page (min 1)\n- `after`/`before`: Cursor strings for pagination\n- `include_total_count`: Set to 'true' to get total subscriber count\n\n**Pitfalls**:\n- If `sort_field` is 'cancelled_at', the `status` must be set to 'cancelled'\n- Date filters use YYYY-MM-DD format (no time component)\n- `email_address` is an exact match; partial email search is not supported\n- Pagination uses cursor-based approach with `after`/`before` cursor strings\n- `include_total_count` is a string 'true', not a boolean\n\n### 2. Manage Subscriber Tags\n\n**When to use**: User wants to tag subscribers for segmentation\n\n**Tool sequence**:\n1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID by email [Prerequisite]\n2. `KIT_TAG_SUBSCRIBER` - Associate a subscriber with a tag [Required]\n3. `KIT_LIST_TAG_SUBSCRIBERS` - List subscribers for a specific tag [Optional]\n\n**Key parameters for tagging**:\n- `tag_id`: Numeric tag ID (required)\n- `subscriber_id`: Numeric subscriber ID (required)\n\n**Pitfalls**:\n- Both `tag_id` and `subscriber_id` must be positive integers\n- Tag IDs must reference existing tags; tags are created via the Kit web UI\n- Tagging an already-tagged subscriber is idempotent (no error)\n- Subscriber IDs are returned from LIST_SUBSCRIBERS; use `email_address` filter to find specific subscribers\n\n### 3. Unsubscribe a Subscriber\n\n**When to use**: User wants to unsubscribe a subscriber from all communications\n\n**Tool sequence**:\n1. `KIT_LIST_SUBSCRIBERS` - Find subscriber ID [Prerequisite]\n2. `KIT_DELETE_SUBSCRIBER` - Unsubscribe the subscriber [Required]\n\n**Key parameters**:\n- `id`: Subscriber ID (required, positive integer)\n\n**Pitfalls**:\n- This permanently unsubscribes the subscriber from ALL email communications\n- The subscriber's historical data is retained but they will no longer receive emails\n- Operation is idempotent; unsubscribing an already-unsubscribed subscriber succeeds without error\n- Returns empty response (HTTP 204 No Content) on success\n- Subscriber ID must exist; non-existent IDs return 404\n\n### 4. List and View Broadcasts\n\n**When to use**: User wants to browse email broadcasts or get details of a specific one\n\n**Tool sequence**:\n1. `KIT_LIST_BROADCASTS` - List all broadcasts with pagination [Required]\n2. `KIT_GET_BROADCAST` - Get detailed information for a specific broadcast [Optional]\n3. `KIT_GET_BROADCAST_STATS` - Get performance statistics for a broadcast [Optional]\n\n**Key parameters for listing**:\n- `per_page`: Results per page (1-500)\n- `after`/`before`: Cursor strings for pagination\n- `include_total_count`: Set to 'true' for total count\n\n**Key parameters for details**:\n- `id`: Broadcast ID (required, positive integer)\n\n**Pitfalls**:\n- `per_page` max is 500 for broadcasts\n- Broadcast stats are only available for sent broadcasts\n- Draft broadcasts will not have stats\n- Broadcast IDs are numeric integers\n\n### 5. Delete a Broadcast\n\n**When to use**: User wants to permanently remove a broadcast\n\n**Tool sequence**:\n1. `KIT_LIST_BROADCASTS` - Find the broadcast to delete [Prerequisite]\n2. `KIT_GET_BROADCAST` - Verify it is the correct broadcast [Optional]\n3. `KIT_DELETE_BROADCAST` - Permanently delete the broadcast [Required]\n\n**Key parameters**:\n- `id`: Broadcast ID (required)\n\n**Pitfalls**:\n- Deletion is permanent and cannot be undone\n- Deleting a sent broadcast removes it but does not unsend the emails\n- Confirm the broadcast ID before deleting\n\n## Common Patterns\n\n### Subscriber Lookup by Email\n\n```\n1. Call KIT_LIST_SUBSCRIBERS with email_address='user@example.com'\n2. Extract subscriber ID from the response\n3. Use ID for tagging, unsubscribing, or other operations\n```\n\n### Pagination\n\nKit uses cursor-based pagination:\n- Check response for `after` cursor value\n- Pass cursor as `after` parameter in next request\n- Continue until no more cursor is returned\n- Use `include_total_count: 'true'` to track progress\n\n### Tag-Based Segmentation\n\n```\n1. Create tags in Kit web UI\n2. Use KIT_TAG_SUBSCRIBER to assign tags to subscribers\n3. Use KIT_LIST_TAG_SUBSCRIBERS to view subscribers per tag\n```\n\n## Known Pitfalls\n\n**ID Formats**:\n- Subscriber IDs: positive integers (e.g., 3887204736)\n- Tag IDs: positive integers\n- Broadcast IDs: positive integers\n- All IDs are numeric, not strings\n\n**Status Values**:\n- Subscriber statuses: 'active', 'inactive', 'cancelled'\n- Some operations are restricted by status (e.g., sorting by cancelled_at requires status='cancelled')\n\n**String vs Boolean Parameters**:\n- `include_total_count` is a string 'true', not a boolean true\n- `sort_order` is a string enum: 'asc' or 'desc'\n\n**Rate Limits**:\n- Kit API has per-account rate limits\n- Implement backoff on 429 responses\n- Bulk operations should be paced appropriately\n\n**Response Parsing**:\n- Response data may be nested under `data` or `data.data`\n- Parse defensively with fallback patterns\n- Cursor values are opaque strings; use exactly as returned\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List subscribers | KIT_LIST_SUBSCRIBERS | status, email_address, per_page |\n| Tag subscriber | KIT_TAG_SUBSCRIBER | tag_id, subscriber_id |\n| List tag subscribers | KIT_LIST_TAG_SUBSCRIBERS | tag_id |\n| Unsubscribe | KIT_DELETE_SUBSCRIBER | id |\n| List broadcasts | KIT_LIST_BROADCASTS | per_page, after |\n| Get broadcast | KIT_GET_BROADCAST | id |\n| Get broadcast stats | KIT_GET_BROADCAST_STATS | id |\n| Delete broadcast | KIT_DELETE_BROADCAST | id |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["convertkit","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-convertkit-automation","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/convertkit-automation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34831 github stars · SKILL.md body (7,284 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-24T06:50:58.233Z","embedding":null,"createdAt":"2026-04-18T21:35:13.940Z","updatedAt":"2026-04-24T06:50:58.233Z","lastSeenAt":"2026-04-24T06:50:58.233Z","tsv":"'-500':598 '/mcp':87 '1':107,154,173,243,335,452,554,597,667,735,800 '2':119,319,345,460,564,677,744,807 '204':516 '3':127,356,434,576,688,751,817 '3887204736':837 '4':142,531 '404':530 '429':910 '5':651 '500':629 'account':904 'action':1023 'activ':59,132,147,190,856 'add':84,101 'address':194,287,428,742,957 'alreadi':412,506 'already-tag':411 'already-unsubscrib':505 'alway':19,69 'api':97,900 'applic':1017 'approach':303 'appropri':917 'asc':234,894 'ask':1061 'assign':813 'associ':349 'auth':136 'authent':141 'autom':3,4,28,32 'avail':58,112,636 'backoff':908 'base':302,765,798 'boolean':318,875,886 'boundari':1069 'broadcast':15,17,535,544,557,560,567,574,579,586,619,631,632,639,641,646,654,664,670,673,680,686,691,695,700,714,725,842,984,987,992,995,998,1002,1006,1009 'brows':165,542 'bulk':912 'call':70,120,736 'cancel':227,266,274,858,868,872 'cannot':708 'check':767 'clarif':1063 'clear':1036 'client':94 'common':729 'communic':449,485 'complet':139 'compon':285 'composio':11,42 'configur':95 'confirm':114,143,723 'connect':54,61,65,123,129,144 'content':518 'continu':781 'convertkit':2,5,26,33 'convertkit-autom':1 'core':152 'correct':685 'count':252,260,311,607,613,791,879 'creat':200,202,403,801 'criteria':1072 'current':24,77 'cursor':246,301,307,601,764,771,774,785,934 'cursor-bas':300,763 'data':490,921,926 'data.data':928 'date':204,215,275 'dd':210,221,281 'defens':930 'delet':462,652,675,690,693,704,711,728,980,1005,1008 'desc':236,896 'describ':1024,1040 'detail':547,569,617 'draft':640 'e.g':836,865 'email':38,169,193,196,286,293,343,427,484,499,543,722,734,741,956 'empti':513 'endpoint':103 'enum':893 'environ':1052 'environment-specif':1051 'error':418,511 'exact':195,290,940 'execut':1019 'exist':399,524,527 'expert':1057 'extract':745 'fallback':932 'field':223,264 'filter':168,180,187,206,217,276,429 'find':339,431,456,671 'first':22,74 'follow':133 'format':282,831 'get':76,81,257,546,566,568,578,581,679,991,994,997,1001 'histor':489 'http':515 'id':226,341,373,376,379,382,387,390,396,420,458,470,472,522,528,618,620,647,699,701,726,747,753,830,833,839,843,847,966,968,977,982,996,1004,1010 'idempot':416,502 'implement':907 'inact':192,857 'includ':250,309,605,789,877 'inform':570 'input':1066 'integ':394,475,623,650,835,841,845 'key':98,184,368,468,588,614,697,948 'kit':6,27,37,44,60,68,126,140,174,336,346,357,406,453,461,555,565,577,668,678,689,737,761,804,809,819,899,952,962,972,979,985,993,1000,1007 'known':35,828 'limit':898,906,1028 'link':137 'list':155,175,177,337,358,361,424,454,532,556,558,591,669,738,820,950,953,969,973,983,986 'longer':497 'lookup':732 'manag':12,64,122,320 'market':39 'match':291,1037 'max':627 'may':922 'mcp':10,31,48,51,83,90,110 'min':242 'miss':1074 'mm':209,220,280 'must':52,270,391,397,523 'need':99 'nest':924 'next':779 'non':526 'non-exist':525 'numer':374,380,649,849 'one':551 'opaqu':937 'oper':40,500,759,860,913 'option':367,575,587,687 'order':233,889 'output':1046 'overview':1027 'pace':916 'page':238,241,593,596,626,959,989 'pagin':182,249,298,562,604,760,766 'param':949 'paramet':185,369,469,589,615,698,777,876 'pars':919,929 'partial':292 'pass':773 'pattern':730,933 'per':237,240,592,595,625,826,903,958,988 'per-account':902 'perform':582 'perman':478,661,692,706 'permiss':1067 'pitfal':261,384,476,624,703,829 'posit':393,474,622,834,840,844 'prerequisit':49,344,459,676 'progress':795 'quick':943 'rang':205,216 'rate':897,905 'receiv':498 'refer':398,944 'remov':662,715 'request':780 'requir':183,355,377,383,467,473,563,621,696,702,870,1065 'respond':118 'respons':514,750,768,911,918,920 'restrict':862 'result':239,594 'retain':492 'return':135,422,512,529,787,942 'review':1058 'rube':9,30,47,50,55,63,71,82,109,115,121 'rube.app':86 'rube.app/mcp':85 'run':149 'safeti':1068 'schema':25,79 'scope':1039 'search':20,56,72,116,157,166,198,294 'segment':332,799 'sent':638,713 'sequenc':172,334,451,553,666 'server':91 'set':253,272,608 'setup':80 'show':146 'skill':1015,1031 'skill-convertkit-automation' 'slug':947 'sort':222,224,232,263,866,888 'source-sickn33' 'specif':365,432,550,573,1053 'stat':18,580,633,645,999,1003 'statist':583 'status':145,186,189,269,852,855,864,871,955 'stop':1059 'string':247,308,314,602,851,873,882,892,938 'subscrib':13,158,170,176,178,259,321,330,338,340,348,351,360,362,378,381,389,414,419,425,433,437,446,455,457,463,466,471,481,487,508,521,731,739,746,811,816,822,825,832,854,951,954,961,964,967,971,975,981 'substitut':1049 'succeed':509 'success':520,1071 'support':297 'tag':14,322,329,347,354,359,366,371,372,375,386,395,400,401,409,413,755,797,802,810,814,821,827,838,960,963,965,970,974,976 'tag-bas':796 'task':7,945,1035 'test':1055 'time':284 'tool':21,57,73,78,117,171,333,450,552,665,946 'toolkit':45,67,125 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'total':251,258,310,606,612,790,878 'track':794 'treat':1044 'true':255,315,610,792,883,887 'ui':408,806 'undon':710 'unsend':720 'unsubscrib':435,444,464,479,503,507,756,978 'updat':211,213,230 'use':161,277,299,325,426,440,538,657,752,762,788,808,818,939,1013,1029 'user':162,326,441,539,658 'user@example.com':743 'valid':1054 'valu':772,853,935 'verifi':108,681 'via':8,29,46,62,404 'view':534,824 'vs':874 'want':163,327,442,540,659 'web':407,805 'without':510 'work':106 'workflow':151,153,1021 'yyyi':208,219,279 'yyyy-mm-dd':207,218,278","prices":[{"id":"f4e7ba6c-a952-43e8-84d7-ecdab6e1c664","listingId":"ef69e94c-3cb8-439a-a636-ba49498af937","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:35:13.940Z"}],"sources":[{"listingId":"ef69e94c-3cb8-439a-a636-ba49498af937","source":"github","sourceId":"sickn33/antigravity-awesome-skills/convertkit-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/convertkit-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:35:13.940Z","lastSeenAt":"2026-04-24T06:50:58.233Z"}],"details":{"listingId":"ef69e94c-3cb8-439a-a636-ba49498af937","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"convertkit-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34831,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"53b23f64aedaf08152f2c13f503b988e889bd0e2","skill_md_path":"skills/convertkit-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/convertkit-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"convertkit-automation","description":"Automate ConvertKit (Kit) tasks via Rube MCP (Composio): manage subscribers, tags, broadcasts, and broadcast stats. Always search tools first for current schemas."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/convertkit-automation"},"updatedAt":"2026-04-24T06:50:58.233Z"}}