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
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.
- 01Repo tree reviewMap folders and key files before any change
Tool used: github__read
Cadence: Per project
- 02Branch inventoryList branches so stale ones are easy to spot
Tool used: github__read
Cadence: Monthly
- 03Find in fileLocate a string in one file with line numbers
Tool used: github__search_file
Cadence: On demand
- 04Article JSON checkCheck published article files for missing fields
Tool used: github__read
Cadence: Weekly
- 05Build setup reviewRead the converter and build workflow files
Tool used: github__read, github__search_file
Cadence: Per site change
- 06Targeted file editFind and replace text in an existing file
Tool used: github__search_file, github__edit_file
Cadence: Per fix
- 07Branch and commitCreate a branch and commit a new file to it
Tool used: github__read, github__write
Cadence: Per change
- 08Open a pull requestOpen a pull request from a branch you name
Tool used: github__read, github__write
Cadence: Per change
- 09Delete stale branchesDelete branches you confirm one by one
Tool used: github__read, github__delete
Cadence: Quarterly
| # | Skill | Job | Tool used | Cadence |
|---|---|---|---|---|
| 01 | Repo tree review | Map folders and key files before any change | github__read | Per project |
| 02 | Branch inventory | List branches so stale ones are easy to spot | github__read | Monthly |
| 03 | Find in file | Locate a string in one file with line numbers | github__search_file | On demand |
| 04 | Article JSON check | Check published article files for missing fields | github__read | Weekly |
| 05 | Build setup review | Read the converter and build workflow files | github__read, github__search_file | Per site change |
| 06 | Targeted file edit | Find and replace text in an existing file | github__search_file, github__edit_file | Per fix |
| 07 | Branch and commit | Create a branch and commit a new file to it | github__read, github__write | Per change |
| 08 | Open a pull request | Open a pull request from a branch you name | github__read, github__write | Per change |
| 09 | Delete stale branches | Delete branches you confirm one by one | github__read, github__delete | 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.
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
Setup
- Chat prompt
- None
- Skill
- Save once for each Claude app
- GitHub connection
- The Ryze AI GitHub App installed on the repositories you choose
Repeatable
- Chat prompt
- Only if you retype it
- Skill
- Yes, the same steps every run
- GitHub connection
- Depends on the prompt or skill
| Chat prompt | Skill | GitHub connection | |
|---|---|---|---|
| What it is | One question typed into chat | A saved file with fixed steps and a fixed output | Tools Claude calls to reach the repository |
| Setup | None | Save once for each Claude app | The Ryze AI GitHub App installed on the repositories you choose |
| Repeatable | Only if you retype it | Yes, the same steps every run | 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.
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.
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.
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.
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.
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.
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.
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.
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
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:
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
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
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
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
github__delete
- What it does
- Runs a DELETE GitHub REST API request, such as deleting a branch or a file
- Used by
- Skill 09
| Tool | What it does | Used by |
|---|---|---|
| github__read | 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 | Skills 01, 02, 04, 05, 07, 08, 09 |
| github__search_file | Searches a file in the connected repository and returns matching lines with line numbers and context | Skills 03, 05, 06 |
| github__edit_file | Makes find-and-replace edits to an existing file in the connected repository and branch and commits the change | Skill 06 |
| github__write | Runs a GitHub REST API request that creates or updates resources, such as committing files, creating branches and opening pull requests | Skills 07, 08 |
| github__delete | Runs a DELETE GitHub REST API request, such as deleting a branch or a file | 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
GitHub connections per Ryze AI workspace
- Value
- 1
- Effect on a skill
- Skills run against the repositories of one GitHub App installation
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
File edit tool
- Value
- Existing files only
- Effect on a skill
- Skill 07 creates new files with the write tool
Contents API, file up to 1 MB
- Value
- All features supported
- Effect on a skill
- Skills 04 and 05 read normal files in full
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
Contents API, file over 100 MB
- Value
- Not supported
- Effect on a skill
- Skills cannot read it through this endpoint
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
Skill name
- Value
- 64 characters, lowercase letters, numbers, hyphens
- Effect on a skill
- Names cannot include claude or anthropic
| Limit | Value | Effect on a skill |
|---|---|---|
| GitHub connections per Ryze AI workspace | 1 | Skills run against the repositories of one GitHub App installation |
| Repository access | Only repositories granted to the Ryze AI GitHub App | A skill cannot read or change a repository the app cannot see |
| File edit tool | Existing files only | Skill 07 creates new files with the write tool |
| Contents API, file up to 1 MB | All features supported | Skills 04 and 05 read normal files in full |
| Contents API, file 1 MB to 100 MB | Only the raw or object media types | A large file may come back without its content field |
| Contents API, file over 100 MB | Not supported | Skills cannot read it through this endpoint |
| Custom skill upload in claude.ai | Pro, Max, Ultra, Team and Enterprise with code execution | Free users can still use the connector but not uploaded skills |
| Skill name | 64 characters, lowercase letters, numbers, hyphens | 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?
Do I need a GitHub connection to use these skills?
Which Claude plan do I need?
How many GitHub tools does Ryze AI give Claude?
Show 6 more questionsShow fewer questions
Will Claude commit or delete without asking?
Can Claude change any file in my repository?
Can GitHub be connected from Claude directly?
How do these differ from GitHub's own MCP server?
Do the skills work outside Claude?
How much does it cost?
Related guides
GitHub publishing with Ryze AI
How Content Plan articles are committed to a repository as JSON files.
Claude skills for WordPress
SKILL.md files for another publishing platform on the same connector.
Claude skills for Webflow
Skills for a site builder and CMS.
How to connect Claude to WordPress
Setup for each Claude app on a publishing platform.




