{"id":"7182b1d7-54e9-4632-a12b-268f22542422","shortId":"KwZbbf","kind":"skill","title":"circleci-automation","tagline":"Automate CircleCI tasks via Rube MCP (Composio): trigger pipelines, monitor workflows/jobs, retrieve artifacts and test metadata. Always search tools first for current schemas.","description":"# CircleCI Automation via Rube MCP\n\nAutomate CircleCI CI/CD operations through Composio's CircleCI toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active CircleCI connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `circleci`\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 `circleci`\n3. If connection is not ACTIVE, follow the returned auth link to complete CircleCI authentication\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Trigger a Pipeline\n\n**When to use**: User wants to start a new CI/CD pipeline run\n\n**Tool sequence**:\n1. `CIRCLECI_TRIGGER_PIPELINE` - Trigger a new pipeline on a project [Required]\n2. `CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID` - Monitor resulting workflows [Optional]\n\n**Key parameters**:\n- `project_slug`: Project identifier in format `gh/org/repo` or `bb/org/repo`\n- `branch`: Git branch to run the pipeline on\n- `tag`: Git tag to run the pipeline on (mutually exclusive with branch)\n- `parameters`: Pipeline parameter key-value pairs\n\n**Pitfalls**:\n- `project_slug` format is `{vcs}/{org}/{repo}` (e.g., `gh/myorg/myrepo`)\n- `branch` and `tag` are mutually exclusive; providing both causes an error\n- Pipeline parameters must match those defined in `.circleci/config.yml`\n- Triggering returns a pipeline ID; workflows start asynchronously\n\n### 2. Monitor Pipelines and Workflows\n\n**When to use**: User wants to check the status of pipelines or workflows\n\n**Tool sequence**:\n1. `CIRCLECI_LIST_PIPELINES_FOR_PROJECT` - List recent pipelines for a project [Required]\n2. `CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID` - List workflows within a pipeline [Required]\n3. `CIRCLECI_GET_PIPELINE_CONFIG` - View the pipeline configuration used [Optional]\n\n**Key parameters**:\n- `project_slug`: Project identifier in `{vcs}/{org}/{repo}` format\n- `pipeline_id`: UUID of a specific pipeline\n- `branch`: Filter pipelines by branch name\n- `page_token`: Pagination cursor for next page of results\n\n**Pitfalls**:\n- Pipeline IDs are UUIDs, not numeric IDs\n- Workflows inherit the pipeline ID; a single pipeline can have multiple workflows\n- Workflow states include: success, running, not_run, failed, error, failing, on_hold, canceled, unauthorized\n- `page_token` is returned in responses for pagination; continue until absent\n\n### 3. Inspect Job Details\n\n**When to use**: User wants to drill into a specific job's execution details\n\n**Tool sequence**:\n1. `CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID` - Find workflow containing the job [Prerequisite]\n2. `CIRCLECI_GET_JOB_DETAILS` - Get detailed job information [Required]\n\n**Key parameters**:\n- `project_slug`: Project identifier\n- `job_number`: Numeric job number (not UUID)\n\n**Pitfalls**:\n- Job numbers are integers, not UUIDs (unlike pipeline and workflow IDs)\n- Job details include executor type, parallelism, start/stop times, and status\n- Job statuses: success, running, not_run, failed, retried, timedout, infrastructure_fail, canceled\n\n### 4. Retrieve Build Artifacts\n\n**When to use**: User wants to download or list artifacts produced by a job\n\n**Tool sequence**:\n1. `CIRCLECI_GET_JOB_DETAILS` - Confirm job completed successfully [Prerequisite]\n2. `CIRCLECI_GET_JOB_ARTIFACTS` - List all artifacts from the job [Required]\n\n**Key parameters**:\n- `project_slug`: Project identifier\n- `job_number`: Numeric job number\n\n**Pitfalls**:\n- Artifacts are only available after job completion\n- Each artifact has a `path` and `url` for download\n- Artifact URLs may require authentication headers to download\n- Large artifacts may have download size limits\n\n### 5. Review Test Results\n\n**When to use**: User wants to check test outcomes for a specific job\n\n**Tool sequence**:\n1. `CIRCLECI_GET_JOB_DETAILS` - Verify job ran tests [Prerequisite]\n2. `CIRCLECI_GET_TEST_METADATA` - Retrieve test results and metadata [Required]\n\n**Key parameters**:\n- `project_slug`: Project identifier\n- `job_number`: Numeric job number\n\n**Pitfalls**:\n- Test metadata requires the job to have uploaded test results (JUnit XML format)\n- If no test results were uploaded, the response will be empty\n- Test metadata includes classname, name, result, message, and run_time fields\n- Failed tests include failure messages in the `message` field\n\n## Common Patterns\n\n### Project Slug Format\n\n```\nFormat: {vcs_type}/{org_name}/{repo_name}\n- GitHub:    gh/myorg/myrepo\n- Bitbucket: bb/myorg/myrepo\n```\n\n### Pipeline -> Workflow -> Job Hierarchy\n\n```\n1. Call CIRCLECI_LIST_PIPELINES_FOR_PROJECT to get pipeline IDs\n2. Call CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID with pipeline_id\n3. Extract job numbers from workflow details\n4. Call CIRCLECI_GET_JOB_DETAILS with job_number\n```\n\n### Pagination\n\n- Check response for `next_page_token` field\n- Pass token as `page_token` in next request\n- Continue until `next_page_token` is absent or null\n\n## Known Pitfalls\n\n**ID Formats**:\n- Pipeline IDs: UUIDs (e.g., `5034460f-c7c4-4c43-9457-de07e2029e7b`)\n- Workflow IDs: UUIDs\n- Job numbers: Integers (e.g., `123`)\n- Do NOT mix up UUIDs and integers between different endpoints\n\n**Project Slugs**:\n- Must include VCS prefix: `gh/` for GitHub, `bb/` for Bitbucket\n- Organization and repo names are case-sensitive\n- Incorrect slug format causes 404 errors\n\n**Rate Limits**:\n- CircleCI API has per-endpoint rate limits\n- Implement exponential backoff on 429 responses\n- Avoid rapid polling; use reasonable intervals (5-10 seconds)\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| Trigger pipeline | CIRCLECI_TRIGGER_PIPELINE | project_slug, branch, parameters |\n| List pipelines | CIRCLECI_LIST_PIPELINES_FOR_PROJECT | project_slug, branch |\n| List workflows | CIRCLECI_LIST_WORKFLOWS_BY_PIPELINE_ID | pipeline_id |\n| Get pipeline config | CIRCLECI_GET_PIPELINE_CONFIG | pipeline_id |\n| Get job details | CIRCLECI_GET_JOB_DETAILS | project_slug, job_number |\n| Get job artifacts | CIRCLECI_GET_JOB_ARTIFACTS | project_slug, job_number |\n| Get test metadata | CIRCLECI_GET_TEST_METADATA | project_slug, job_number |\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":["circleci","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-circleci-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/circleci-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 · 34882 github stars · SKILL.md body (6,796 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-24T12:50:45.028Z","embedding":null,"createdAt":"2026-04-18T21:34:13.286Z","updatedAt":"2026-04-24T12:50:45.028Z","lastSeenAt":"2026-04-24T12:50:45.028Z","tsv":"'-10':835 '/mcp':82 '1':102,149,167,285,420,510,594,691 '123':775 '2':114,179,265,298,433,520,604,702 '3':122,311,400,713 '4':137,490,720 '404':810 '429':826 '4c43':765 '5':575,834 '5034460f':763 '5034460f-c7c4-4c43':762 '9457':766 'absent':399,751 'action':927 'activ':54,127,142 'add':79,96 'alway':20,64 'api':92,815 'applic':921 'artifact':16,493,503,524,527,544,552,560,569,895,899 'ask':965 'asynchron':264 'auth':131 'authent':136,564 'autom':3,4,28,32 'avail':53,107,547 'avoid':828 'backoff':824 'bb':795 'bb/myorg/myrepo':686 'bb/org/repo':200 'bitbucket':685,797 'boundari':973 'branch':201,203,220,238,340,344,851,862 'build':492 'c7c4':764 'call':65,115,692,703,721 'cancel':387,489 'case':804 'case-sensit':803 'caus':246,809 'check':276,585,730 'ci/cd':34,162 'circleci':2,5,27,33,39,55,63,121,135,168,180,286,299,312,421,434,511,521,595,605,693,704,722,814,846,855,865,876,885,896,907 'circleci-autom':1 'circleci/config.yml':256 'clarif':967 'classnam':654 'clear':940 'client':89 'common':671 'complet':134,517,550 'composio':10,37 'config':315,875,879 'configur':90,319 'confirm':109,138,515 'connect':49,56,60,118,124,139 'contain':429 'continu':397,745 'core':147 'criteria':976 'current':25,72 'cursor':349 'de07e2029e7b':767 'defin':254 'describ':928,944 'detail':403,417,437,439,469,514,598,719,725,884,888 'differ':784 'download':500,559,567,572 'drill':410 'e.g':236,761,774 'empti':650 'endpoint':98,785,819 'environ':956 'environment-specif':955 'error':248,383,811 'exclus':218,243 'execut':416,923 'executor':471 'expert':961 'exponenti':823 'extract':714 'fail':382,384,484,488,662 'failur':665 'field':661,670,736 'filter':341 'find':427 'first':23,69 'follow':128 'format':197,231,332,639,675,676,757,808 'get':71,76,313,435,438,512,522,596,606,699,723,873,877,882,886,893,897,904,908 'gh':792 'gh/myorg/myrepo':237,684 'gh/org/repo':198 'git':202,210 'github':683,794 'header':565 'hierarchi':690 'hold':386 'id':185,261,304,334,357,362,367,426,467,701,709,712,756,759,769,870,872,881 'identifi':195,327,448,537,620 'implement':822 'includ':377,470,653,664,789 'incorrect':806 'inform':441 'infrastructur':487 'inherit':364 'input':970 'inspect':401 'integ':460,773,782 'interv':833 'job':402,414,431,436,440,449,452,457,468,478,507,513,516,523,530,538,541,549,591,597,600,621,624,631,689,715,724,727,771,883,887,891,894,898,902,913 'junit':637 'key':93,190,225,322,443,532,615,842 'key-valu':224 'known':754 'larg':568 'limit':574,813,821,932 'link':132 'list':181,287,291,300,305,422,502,525,694,705,853,856,863,866 'manag':59,117 'match':252,941 'may':562,570 'mcp':9,31,43,46,78,85,105 'messag':657,666,669 'metadata':19,608,613,628,652,906,910 'miss':978 'mix':778 'monitor':13,186,266 'multipl':373 'must':47,251,788 'mutual':217,242 'name':345,655,680,682,801 'need':94 'new':161,173 'next':351,733,743,747 'null':753 'number':450,453,458,539,542,622,625,716,728,772,892,903,914 'numer':361,451,540,623 'oper':35 'option':189,321 'org':234,330,679 'organ':798 'outcom':587 'output':950 'overview':931 'page':346,352,389,734,740,748 'pagin':348,396,729 'pair':227 'parallel':473 'param':843 'paramet':191,221,223,250,323,444,533,616,852 'pass':737 'path':555 'pattern':672 'per':818 'per-endpoint':817 'permiss':971 'pipelin':12,152,163,170,174,184,207,215,222,249,260,267,280,288,293,303,309,314,318,333,339,342,356,366,370,425,464,687,695,700,708,711,758,845,848,854,857,869,871,874,878,880 'pitfal':228,355,456,543,626,755 'poll':830 'prefix':791 'prerequisit':44,432,519,603 'produc':504 'project':177,192,194,229,290,296,324,326,445,447,534,536,617,619,673,697,786,849,859,860,889,900,911 'provid':244 'quick':837 'ran':601 'rapid':829 'rate':812,820 'reason':832 'recent':292 'refer':838 'repo':235,331,681,800 'request':744 'requir':178,297,310,442,531,563,614,629,969 'respond':113 'respons':394,647,731,827 'result':187,354,578,611,636,643,656 'retri':485 'retriev':15,491,609 'return':130,258,392 'review':576,962 'rube':8,30,42,45,50,58,66,77,104,110,116 'rube.app':81 'rube.app/mcp':80 'run':144,164,205,213,379,381,481,483,659 'safeti':972 'schema':26,74 'scope':943 'search':21,51,67,111 'second':836 'sensit':805 'sequenc':166,284,419,509,593 'server':86 'setup':75 'show':141 'singl':369 'size':573 'skill':919,935 'skill-circleci-automation' 'slug':193,230,325,446,535,618,674,787,807,841,850,861,890,901,912 'source-sickn33' 'specif':338,413,590,957 'start':159,263 'start/stop':474 'state':376 'status':140,278,477,479 'stop':963 'substitut':953 'success':378,480,518,975 'tag':209,211,240 'task':6,839,939 'test':18,577,586,602,607,610,627,635,642,651,663,905,909,959 'time':475,660 'timedout':486 'token':347,390,735,738,741,749 'tool':22,52,68,73,112,165,283,418,508,592,840 'toolkit':40,62,120 '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' 'treat':948 'trigger':11,150,169,171,257,844,847 'type':472,678 'unauthor':388 'unlik':463 'upload':634,645 'url':557,561 'use':155,272,320,406,496,581,831,917,933 'user':156,273,407,497,582 'uuid':335,359,455,462,760,770,780 'valid':958 'valu':226 'vcs':233,329,677,790 'verifi':103,599 'via':7,29,41,57 'view':316 'want':157,274,408,498,583 'within':307 'work':101 'workflow':146,148,182,188,262,269,282,301,306,363,374,375,423,428,466,688,706,718,768,864,867,925 'workflows/jobs':14 'xml':638","prices":[{"id":"e0969b6a-405a-4c7e-a230-a08fc5d0c0bf","listingId":"7182b1d7-54e9-4632-a12b-268f22542422","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:34:13.286Z"}],"sources":[{"listingId":"7182b1d7-54e9-4632-a12b-268f22542422","source":"github","sourceId":"sickn33/antigravity-awesome-skills/circleci-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/circleci-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:34:13.286Z","lastSeenAt":"2026-04-24T12:50:45.028Z"}],"details":{"listingId":"7182b1d7-54e9-4632-a12b-268f22542422","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"circleci-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34882,"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":"8580ec95797525ee50c384574abb19e35a6c7677","skill_md_path":"skills/circleci-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/circleci-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"circleci-automation","description":"Automate CircleCI tasks via Rube MCP (Composio): trigger pipelines, monitor workflows/jobs, retrieve artifacts and test metadata. Always search tools first for current schemas."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/circleci-automation"},"updatedAt":"2026-04-24T12:50:45.028Z"}}