apify-fix-git-connection
Repair an Apify Actor's broken Git connection - pushes to GitHub that no longer start a build, builds that fail to clone the repository, or a GitHub integration rejected as invalid or expired (for example after Apify API tokens were revoked)
Install / Use
npx skills add apify/agent-skills --skill apify-fix-git-connectionInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OperationsSupported Platforms
Our assessment of apify-fix-git-connection
apify-fix-git-connection scores 91/100 on our quality scale, 274th of 755 Operations skills we index (top 37%).
Its SKILL.md is 7.0 KB long, split into 7 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
With 2,398 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so apify-fix-git-connection is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
apify-fix-git-connection compared with similar skills
All 4 of these similar skills score higher than apify-fix-git-connection; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| apify-fix-git-connection (this skill)by apify | 91 | 2.4k | 55d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP Server |
Frequently asked questions
- How do I install apify-fix-git-connection?
- Run
npx skills add apify/agent-skills --skill apify-fix-git-connection. The install tabs above show the steps for each supported agent. - Which AI agents does apify-fix-git-connection work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is apify-fix-git-connection safe to use?
- It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is apify-fix-git-connection still maintained?
- The repository was last updated about 2 months ago, so apify-fix-git-connection is actively maintained.
Skill content
View source on GitHubname: apify-fix-git-connection description: Repair an Apify Actor's broken Git connection - pushes to GitHub that no longer start a build, builds that fail to clone the repository, or a GitHub integration rejected as invalid or expired (for example after Apify API tokens were revoked). Use when a Git-sourced Actor stopped deploying from its repository.
Fix an Actor's Git connection
A Git-sourced Actor deploys through two links, and each one breaks on its own:
- Clone: Apify reads the repository when it builds.
- Trigger: a push to the repository starts that build.
Diagnose both links, repair the broken ones, then prove the chain with one push. Runs keep using the last successful build the whole time, so the Actor stays up while you work.
The steps use the Apify CLI (apify login first) and the GitHub CLI (gh). They are written for GitHub; GitLab and Bitbucket have the same two links behind different commands and screens.
Two rules hold in every step:
- Ask before a deploy. A successful build moves the version's build tag (usually
latest) to the head of the branch, so starting a build and pushing a commit are both deploys. Get the user's go-ahead for each. - Tokens stay with the user. A webhook URL embeds an Apify API token. Print only its host, as the commands below do, and judge a delivery by its status code: its response body repeats the URL. The user performs every step that handles a key, a token or that URL.
1. Find the Git version
apify api GET '/v2/actors/<username>~<actor-name>'
apify api GET '/v2/actors/<username>~<actor-name>/builds?desc=true&limit=5'
In versions, take the entry with sourceType: "GIT_REPO" and note its versionNumber, gitRepoUrl and buildTag. In taggedBuilds, note the build that tag points at. An Actor with no GIT_REPO version deploys with apify push and is outside this skill.
Done when you can name the version, its repository URL, and the build that is live.
2. Diagnose the clone link
Read the log of the newest build of that version:
apify api GET '/v2/actor-builds/<buildId>/log'
| Log line | Clone link |
| --------------------------------------- | ---------- |
| Cloned commit ID: <sha> | Works |
| Could not read from remote repository | Broken |
A build from before the trouble started proves nothing. In that case start a fresh one (a deploy) and read its log:
apify api POST '/v2/actors/<username>~<actor-name>/builds?version=<versionNumber>'
Done when a build newer than the trouble shows one of the two lines.
3. Diagnose the trigger link
gh api repos/<owner>/<repo>/hooks --jq '.[] | {id, active, events, host: (.config.url | split("/")[2]), last_response_code: .last_response.code}'
gh api 'repos/<owner>/<repo>/hooks/<hookId>/deliveries?per_page=5' --jq '.[] | {delivered_at, event, status_code}'
An Apify webhook has the host console-backend.apify.com (registered by Apify's GitHub App) or api.apify.com (a Build Actor webhook added by hand).
| What the repository shows | Trigger link |
| --------------------------------------------- | ------------------------------------------------------------- |
| One Apify webhook, latest push delivery 2xx | Works |
| Latest push delivery 400 or 401 | Broken: Apify rejects the token in the webhook URL |
| No Apify webhook | Broken: nothing starts a build |
| Two Apify webhooks answering 2xx | Works, but every push starts two builds: the user deletes one |
Done when every Apify webhook on the repository is in one row of the table.
4. Repair the clone link
A private repository needs the SSH form of the Git URL plus the Actor's deployment key. The user does this:
- In Apify Console, open the Actor's Source tab and select the Git version in Version.
- Set Git URL to
git@github.com:<owner>/<repo>.gitand save. The HTTPS form only clones public repositories. - Click the deployment key link below the URL field and copy the key.
- On GitHub, open the repository's Settings > Deploy keys > Add deploy key, paste the key, leave Allow write access unchecked, and save.
Confirm the key with gh api repos/<owner>/<repo>/keys --jq '.[] | {title, read_only, created_at}', then start a build (step 2) and read its log.
Done when a build log shows Cloned commit ID with the head of the branch.
5. Repair the trigger link
First let Apify register the webhook itself:
apify api PUT '/v2/actors/<username>~<actor-name>/versions/<versionNumber>/build-on-push' -d '{"providerId":"github-app","enabled":true}'
- No error: automatic builds are on. Have the user delete any older Apify webhook that still fails, then go to step 6.
invalid-git-auth-token: Apify's GitHub authorization is dead. Use a Build Actor webhook instead; it depends only on the clone link.
For the Build Actor webhook, the user does this:
- In Apify Console, open Settings > API & Integrations and select Create a new token. Name it after the webhook, for example
GitHub build webhook for <repo>, and copy its value: Console shows a token's value once, at creation, so an existing token cannot be reused here. - On the Actor page, open API > API endpoints, select the new token in the token dropdown, and copy the Build Actor URL.
- Check that the URL has
token=<the new token>andversion=<versionNumber>, and deletewaitForFinishfrom it: GitHub gives a webhook 10 seconds to answer, less than a build takes. - On GitHub, open the repository's Settings > Webhooks > Add webhook. Paste the URL into Payload URL, set Content type to
application/json, keep Just the push event, and save. - On the same page, delete every other Apify webhook.
Adding the webhook makes GitHub send a ping, which starts one build: a deploy, so tell the user before step 4, and expect that build in step 6.
Done when the listing from step 3 shows exactly one active Apify webhook.
6. Prove the chain with one push
Push one commit to the branch the version builds from: the default branch, or the one after # in gitRepoUrl. An empty commit is enough:
git commit --allow-empty -m "Trigger build to test the build webhook"
git push
Then check all four:
- The webhook has one new
pushdelivery with a 2xx status. - Exactly one build started after the push.
- That build's log shows
Cloned commit IDequal to the pushed commit. taggedBuilds.<buildTag>points at that build.
Done when all four hold. A failed check sends you back to the step for its link: the first two to the trigger link, the last two to the clone link.
Close by telling the user that a Build Actor webhook carries the API token they created for it: when that token is rotated, deleted or expires, pushes stop building without any notice, and the cure is step 5 again.
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
