Ira Bodnar··Updated ·12 min read

Claude Skills for GitHub: 9 SKILL.md Files for Repos, Branches and Pull Requests

Quick answer: Save each GitHub chore as a Claude skill that names the tool to call and the table to hand back. Ryze AI is the best Claude connector for running these skills on the repositories a publishing workflow touches in 2026, with one caveat: it reaches only the repositories you grant the Ryze AI GitHub App, and GitHub is connected in the Ryze AI app, not from Claude.

Below: 9 SKILL.md files, which of the 5 GitHub tools each one calls, install steps, the limits that apply and a short troubleshooting list.

Ryze AI · SEO Starter

GitHub skills on your own repositories

  • 3-day free trial, $129 a month

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 9 Claude skills for GitHub at a glance

Five skills only read, three write and one removes. Each names the Ryze AI tool it calls.

  1. 01Repo tree reviewMap folders and key files before any change

    Tool used: github__read

    Cadence: Per project

  2. 02Branch inventoryList branches so stale ones are easy to spot

    Tool used: github__read

    Cadence: Monthly

  3. 03Find in fileLocate a string in one file with line numbers

    Tool used: github__search_file

    Cadence: On demand

  4. 04Article JSON checkCheck published article files for missing fields

    Tool used: github__read

    Cadence: Weekly

  5. 05Build setup reviewRead the converter and build workflow files

    Tool used: github__read, github__search_file

    Cadence: Per site change

  6. 06Targeted file editFind and replace text in an existing file

    Tool used: github__search_file, github__edit_file

    Cadence: Per fix

  7. 07Branch and commitCreate a branch and commit a new file to it

    Tool used: github__read, github__write

    Cadence: Per change

  8. 08Open a pull requestOpen a pull request from a branch you name

    Tool used: github__read, github__write

    Cadence: Per change

  9. 09Delete stale branchesDelete branches you confirm one by one

    Tool used: github__read, github__delete

    Cadence: Quarterly

The tool names and descriptions come from the Ryze AI integration source and the Ryze AI help center. No skill here was run against a live repository, and no output from a real repository appears. Run each skill on a test repository first.

What are Claude skills for GitHub?

A Claude skill for GitHub is a SKILL.md file that tells Claude how to run one repository task and what to return. Anthropic's Agent Skills docs say the file opens with a name and a description. Claude loads those two fields at startup and reads the rest of the file only when a request matches the description.

The name takes up to 64 characters, lowercase letters, numbers and hyphens, and cannot contain the reserved words anthropic or claude. The description is capped at 1,024 characters and must say what the skill does and when to use it. Every skill here starts with github for that reason.

  1. What it is

    Chat prompt
    One question typed into chat
    Skill
    A saved file with fixed steps and a fixed output
    GitHub connection
    Tools Claude calls to reach the repository
  2. Setup

    Chat prompt
    None
    Skill
    Save once for each Claude app
    GitHub connection
    The Ryze AI GitHub App installed on the repositories you choose
  3. Repeatable

    Chat prompt
    Only if you retype it
    Skill
    Yes, the same steps every run
    GitHub connection
    Depends on the prompt or skill

A skill holds instructions and no credentials, so one file works on any repository you grant. Ryze AI also commits Content Plan articles to a repository as JSON files; the GitHub page covers that side. This page covers what you can ask Claude to do in the same repositories.

How to install the GitHub skills in Claude

Claude Code

Put each block in ~/.claude/skills/<skill-name>/SKILL.md for yourself, or in .claude/skills/<skill-name>/SKILL.md inside a project to share it. Type /github-open-pr to call a skill by name, or let Claude pick it from the description (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skills on Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the repository

Install the Ryze AI GitHub App in the Ryze AI app, then add the Ryze AI connector to Claude. The steps are in the next sections and in the Ryze AI help center.

Anthropic states that custom skills do not sync between surfaces: a skill uploaded to claude.ai is absent from the API, and Claude Code skills live on disk apart from both. Anthropic also advises using skills only from sources you trust, so read each file before you save it, the ones on this page included.

The three skills that write and the one that deletes carry disable-model-invocation: true in their frontmatter. Per the Claude Code docs, that stops Claude from loading a skill by itself and leaves it to you to type the slash command. It applies to Claude Code, and it does not replace per-tool approvals in the connector.

Read skills: understand the repository before you change it

These five call github__read, which runs a read-only GitHub REST API request in repositories the Ryze AI GitHub App is installed on, or github__search_file, which returns matching lines with line numbers and context. None of them changes anything.

01. Repo tree review

Maps the folders and main files of one repository so you know where things live before you ask for an edit.

SKILL.md
--- name: github-tree-review description: Reads the file tree of one connected GitHub repository and branch and summarizes the folder layout. Use when asked what is in a repo or before any file change. --- # GitHub repo tree review Use github__read only. Do not call github__write, github__edit_file or github__delete. Steps: 1. Ask me for the repository and branch if I did not name them. 2. Read the file tree of that branch. 3. Identify the top-level folders, the package or build config files and any folder that looks like content, such as blog or posts. Output: a short table of folder, purpose and the files that matter most. Say which folder looks like it holds site content. Change nothing.

Use it when: you inherit a repository or plan a change you have not scoped.

02. Branch inventory

Lists the branches of one repository so old ones are easy to spot.

SKILL.md
--- name: github-branch-inventory description: Lists the branches of one connected GitHub repository. Use when asked which branches exist, which look stale or before a cleanup. --- # GitHub branch inventory Use github__read only. Steps: 1. Ask me for the repository if I did not name it. 2. List its branches and tell me which one is the default. 3. Group the rest by naming pattern, such as feature, fix or a date. Output: a table of branch name and the group it falls in. Mark names that look temporary. Delete nothing.

Use it when: the branch list has grown and nobody remembers what is live.

03. Find in file

Searches one file for a string and returns the matching lines with line numbers and context, which makes a later edit precise.

SKILL.md
--- name: github-find-in-file description: Searches one file in the connected GitHub repository for a string and returns the matching lines. Use when asked where something is set or used in a file. --- # GitHub find in file Use github__search_file only. Steps: 1. Ask me for the file path, the branch and the text to look for if any is missing. 2. Search that file for the text. 3. If nothing matches, say so and offer two nearby spellings to try. Output: each match with its line number and a few lines of context. Make no edits.

Use it when: a config value or a redirect needs checking and you know which file holds it.

04. Article JSON check

Ryze AI commits each published Content Plan article as one JSON file at the folder path you set (the default is blog/data). This skill reads those files and reports gaps.

SKILL.md
--- name: github-article-json-check description: Reads the published article JSON files in the connected GitHub repository and flags missing fields. Use when checking what Ryze AI published or before a site build. --- # GitHub article JSON check Use github__read only. Steps: 1. Ask me for the repository, branch and folder path. The default folder is blog/data. 2. Read the JSON files in that folder. 3. For each file, check that slug, title, body_markdown, body_html, meta_title, meta_description, excerpt, primary_keyword, image, published_at, updated_at and status are present. Output: a table of file name and the fields that are missing or empty. If every file is complete, say so. Change nothing.

Use it when: an article is missing from the site and you want to know whether the file is in the repository.

05. Build setup review

A site needs its own converter and build step to render the JSON files as pages. This skill reads those files so you can see what the repository does with them.

SKILL.md
--- name: github-build-setup-review description: Reads the build workflow and converter files of the connected GitHub repository. Use when published articles do not show up as pages. --- # GitHub build setup review Use github__read and github__search_file only. Steps: 1. Ask me for the repository and branch. 2. Read the files under .github/workflows and any script or page file that mentions the article folder. 3. Use search to find where the folder path, such as blog/data, is referenced. Output: where the JSON files are read, which workflow runs on a push and anything that looks like a missing step. Do not propose edits until I ask.

Use it when: files are committed but no page appears.

Write skills: edit files, commit and open pull requests

These three call github__edit_file or github__write. The edit tool makes find-and-replace edits to an existing file in the connected repository and branch and commits the change. The write tool runs a GitHub REST API request that creates or updates resources, such as committing files, creating branches and opening pull requests. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval, the setting the Ryze AI help center recommends.

One scope warning: the write and delete tools are not limited to the article folder. They can act anywhere in the repositories the Ryze AI GitHub App is installed on. Grant the app only the repositories you want Claude to change.

06. Targeted file edit

Replaces specific text in an existing file and commits it. The edit tool changes only files that already exist.

SKILL.md
--- name: github-edit-file description: Makes a find-and-replace edit to one existing file in the connected GitHub repository and branch. Use when asked to fix a typo, a URL or a config value in a file. disable-model-invocation: true --- # GitHub targeted file edit Uses github__search_file and github__edit_file. Edit only existing files. Steps: 1. Ask me for the file path, the branch, the exact text to replace and the new text. 2. Search the file for the old text and show me every match with its line number. 3. If there is more than one match, ask which to change. 4. Show the planned replacement and wait for my yes. 5. Make the edit. Output: the file, the branch, the lines changed and the old and new text.

Use it when: a link or value is wrong in one file and a full pull request is more than you need. Name a branch other than the default one if you want the change reviewed first.

07. Branch and commit

Creates a branch and commits a new file to it, so the change can be reviewed before it reaches the default branch. New files are created with the write tool, not the edit tool.

SKILL.md
--- name: github-branch-commit description: Creates a branch in the connected GitHub repository and commits one new file to it. Use when asked to add a file without touching the default branch. disable-model-invocation: true --- # GitHub branch and commit Uses github__read and github__write. Never write to the default branch. Steps: 1. Ask me for the repository, a branch name, the file path and the file content. 2. Read the tree to confirm the path is free and say which branch the new one starts from. 3. Show the branch name, the path and the content summary and wait for my yes. 4. Create the branch, then commit the file to it. Output: the branch, the file path and what was committed. Remind me that nothing is merged yet.

Use it when: you want a new page, data file or workflow file reviewed before it goes live.

08. Open a pull request

Opens a pull request from a branch you name into the branch you choose, with a description Claude writes from the changes.

SKILL.md
--- name: github-open-pr description: Opens a pull request in the connected GitHub repository from a branch I name. Use when changes are on a branch and ready for review. disable-model-invocation: true --- # GitHub open pull request Uses github__read and github__write. Do not merge anything. Steps: 1. Ask me for the repository, the source branch and the target branch. 2. Read the files changed on the source branch and summarize them in plain sentences. 3. Draft a title and a description. Show both and wait for my yes. 4. Open the pull request. Output: the pull request title and the branches involved. Say that review and merging are left to me.

Use it when: Claude or a teammate committed to a branch and a review should start.

Cleanup skill: delete branches with a confirmation step

github__delete runs a DELETE GitHub REST API request, such as deleting a branch or a file. It sits apart from write, so you can allow commits and keep deletions on approval.

09. Delete stale branches

SKILL.md
--- name: github-delete-branches description: Deletes the GitHub branches I confirm in the connected repository. Use for merged or abandoned branches after a review of the branch list. disable-model-invocation: true --- # GitHub delete stale branches Uses github__read and github__delete. Never delete the default branch. Steps: 1. Ask me for the repository and the rule, such as branches that start with test or that I list by name. 2. List the matching branches. Delete nothing yet. 3. Show the list and wait for me to confirm each branch. 4. Delete only the confirmed branches, one at a time, and report each result. Output: branches deleted and branches skipped. Remind me that a deleted branch needs to be pushed again to come back.

Use it when: you are tidying a repository after a launch. Keep Needs approval on the delete tool in Claude, in addition to the skill's own confirmation step. GitHub documents that the create-or-update file endpoint and the delete file endpoint conflict when run in parallel, so the skill deletes one item at a time.

How to run the skills on live GitHub repositories

A skill describes the work and Claude needs a connection to do it. The Ryze AI connector gives Claude 5 GitHub tools:

  1. github__read

    What it does
    Runs a read-only GitHub REST API request in repositories the Ryze AI GitHub App is installed on, such as file contents, trees and branches, with paging for large files
    Used by
    Skills 01, 02, 04, 05, 07, 08, 09
  2. github__search_file

    What it does
    Searches a file in the connected repository and returns matching lines with line numbers and context
    Used by
    Skills 03, 05, 06
  3. github__edit_file

    What it does
    Makes find-and-replace edits to an existing file in the connected repository and branch and commits the change
    Used by
    Skill 06
  4. github__write

    What it does
    Runs a GitHub REST API request that creates or updates resources, such as committing files, creating branches and opening pull requests
    Used by
    Skills 07, 08
  5. github__delete

    What it does
    Runs a DELETE GitHub REST API request, such as deleting a branch or a file
    Used by
    Skill 09

To connect, open Integrations in the Ryze AI app and click Connect on the GitHub card. Choose Set up with Agent, which opens a chat that walks you through the converter and build workflow setup in your repository, or I'll do it manually. In the manual path GitHub opens, where you choose the account or organization and grant access to the repositories Ryze AI should use. GitHub then returns you to Ryze AI, where you set the Repository, Blog URL, Branch and Folder path (Ryze AI GitHub guide).

The connector needs an active Ryze AI plan or trial, and connecting it costs nothing. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year (pricing). GitHub cannot be connected from Claude with a connection link, so connect it in Ryze AI first. After that, remove the Ryze AI connector in Claude, add it again and start a new chat, because Claude keeps the tool list from the moment the connector was added (Ryze AI help center).

A workspace holds one GitHub connection. The app installation can be granted several repositories, while article publishing goes to the one repository you configured, so a skill that names another granted repository should say so in the request.

GitHub publishes its own MCP server, github/github-mcp-server. The remote server is at https://api.githubcopilot.com/mcp/ and signs in with OAuth or a personal access token, and a local version runs from the ghcr.io/github/github-mcp-server Docker image. It groups tools into toolsets such as repos, issues and pull_requests and has a read-only mode (GitHub README). Its tool names differ from the Ryze AI names, so a skill written for github__read needs editing before it works there. The GitHub server lists toolsets for issues and pull requests, areas the Ryze AI GitHub tools do not name, so pick it when you need those.

Limits that shape these skills

  1. GitHub connections per Ryze AI workspace

    Value
    1
    Effect on a skill
    Skills run against the repositories of one GitHub App installation
  2. Repository access

    Value
    Only repositories granted to the Ryze AI GitHub App
    Effect on a skill
    A skill cannot read or change a repository the app cannot see
  3. File edit tool

    Value
    Existing files only
    Effect on a skill
    Skill 07 creates new files with the write tool
  4. Contents API, file up to 1 MB

    Value
    All features supported
    Effect on a skill
    Skills 04 and 05 read normal files in full
  5. Contents API, file 1 MB to 100 MB

    Value
    Only the raw or object media types
    Effect on a skill
    A large file may come back without its content field
  6. Contents API, file over 100 MB

    Value
    Not supported
    Effect on a skill
    Skills cannot read it through this endpoint
  7. Custom skill upload in claude.ai

    Value
    Pro, Max, Ultra, Team and Enterprise with code execution
    Effect on a skill
    Free users can still use the connector but not uploaded skills
  8. Skill name

    Value
    64 characters, lowercase letters, numbers, hyphens
    Effect on a skill
    Names cannot include claude or anthropic

GitHub documents its REST API rate limits per account type: 60 requests an hour without authentication, 5,000 an hour for an authenticated user and at least 5,000 an hour for a GitHub App installation, rising with the number of repositories and users. It also sets secondary limits of no more than 80 content-generating requests a minute and 500 an hour. The page does not say which limit applies to calls made through Ryze AI, so treat these as GitHub's published figures and ask Claude to work in small batches if a skill hits a rate error (GitHub rate limits).

Troubleshooting: when a GitHub skill fails

Claude has no GitHub tools

Claude keeps the tool list from when the connector was added. Connect GitHub in Ryze AI first, then remove and re-add the connector and start a new chat.

Claude cannot see a repository

The Ryze AI GitHub App reaches only the repositories you granted. Grant the repository to the app in GitHub, then try again.

Edit fails on a new file

The edit tool changes only files that already exist. Use skill 07, which creates files with the write tool.

Edit finds no match

The old text must match the file. Run skill 03 first to see the exact lines, then copy the text.

Errors when creating and deleting files together

GitHub says the create-or-update and delete file endpoints conflict when used in parallel and must run one after the other. Ask Claude to do one change at a time.

A large file comes back empty

For files between 1 MB and 100 MB the contents endpoint returns only the raw or object media types, and the content field can be empty. Over 100 MB it is not supported.

Articles committed but no pages

Your site needs its own converter and build step to render the JSON files. Run skill 05 to see what the repository does with them.

A skill does not start in Claude Code

Check the path is ~/.claude/skills/<name>/SKILL.md. Skills marked disable-model-invocation: true start only when you type the slash command.

Sources

The verdict

Turn each recurring repository chore into a skill that names its tool and ends with a confirmation step. Start with the tree review and the file search, then add the write skills once approvals are set.

Ryze AI runs these skills in Claude through 5 GitHub tools on the repositories you grant the Ryze AI GitHub App. Grant only what Claude should be able to change, because the write and delete tools reach beyond the article folder.

Frequently asked questions

What are Claude skills for GitHub?
SKILL.md files that tell Claude which GitHub task to run, which Ryze AI tool to call and how to present the result. Claude loads one when a request matches its description, so a branch review or a pull request step runs the same way each time.
Do I need a GitHub connection to use these skills?
To run them on your repositories, yes. Without one, Claude can follow the steps on pasted files, but it cannot read or change a repository.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
How many GitHub tools does Ryze AI give Claude?
5: github__read, github__write, github__delete, github__edit_file and github__search_file. Read runs read-only requests such as file contents, trees and branches. Write commits files, creates branches and opens pull requests. Delete removes a branch or a file. Edit makes find-and-replace changes to an existing file. Search returns matching lines from one file.
Show 6 more questions
Will Claude commit or delete without asking?
That depends on your settings. In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set write and delete tools to Needs approval. The write and delete skills on this page also ask for a yes before each change.
Can Claude change any file in my repository?
In repositories the Ryze AI GitHub App is installed on, yes. The write and delete tools can commit, create branches, open pull requests and delete files there, so the folder path you set for article publishing does not limit them. Grant the app only the repositories you want Claude to change.
Can GitHub be connected from Claude directly?
No. GitHub is connected in the Ryze AI app by installing the Ryze AI GitHub App. After that, Claude reaches it through the Ryze AI connector. A workspace holds one GitHub connection.
How do these differ from GitHub's own MCP server?
GitHub publishes github/github-mcp-server, with a remote server at https://api.githubcopilot.com/mcp/ that signs in with OAuth or a personal access token, and a local Docker version. It has its own tool names and toolsets. Ryze AI exposes 5 GitHub tools through one connector URL, https://connector.get-ryze.ai/mcp, and the GitHub access is the Ryze AI GitHub App you install.
Do the skills work outside Claude?
SKILL.md is the format Claude reads. The GitHub tools on the Ryze AI connector work in other MCP clients, where you can paste a skill's steps into a prompt.
How much does it cost?
Connecting the Ryze AI connector is free, and the GitHub tools need an active plan or trial. SEO Starter is $129 a month with a 3-day free trial, and annual billing is 30% off the first year.

Related guides

Ryze AI: GitHub skills on your repositories

3-day free trial, $129 a month

Start free trial