Agent skill

GitHub API

GitHub API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

Install GitHub API

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/github-api .claude/skills/github-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .claude/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/github-api .agents/skills/github-api && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .agents/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/github-api .cursor/skills/github-api && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .cursor/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/CraftOS-dev/CraftBot.git --path skills/github-api

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/github-api .gemini/skills/github-api && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .gemini/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/github-api .github/skills/github-api && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .github/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add CraftOS-dev/CraftBot --skill github-api -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install CraftOS-dev/CraftBot github-api --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/github-api .opencode/skills/github-api && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "github-api" agent skill from https://github.com/CraftOS-dev/CraftBot/tree/main/skills/github-api into .opencode/skills/github-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-api", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: github-api
GitHub stars: 392
Token cost: ~3.9k tokens
SKILL.md length: 698 words
Files: 4
Skills in repo: 89
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

GitHub API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

Works in 3 steps: Sign in or create an account at maton.ai → Go to maton.ai/settings → Copy your API key
Users want to interact with GitHub repositories
SKILL.md covers Quick Start, Base URL, Authentication and Connection Management, plus 3 more sections
Calls python and curl; reaches gateway.maton.ai and ctrl.maton.ai; needs MATON_API_KEY

What it does

GitHub API is an agent skill from CraftOS-dev/CraftBot. GitHub API integration with managed OAuth. Access repositories, issues, pull requests, commits, branches, and users. Use this skill when users want to interact with GitHub repositories, manage issues and PRs, search code, or automate workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).

Its SKILL.md is about 3.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `.clawhub/origin.json` and `_meta.json`). Compatibility notes: Requires network access and valid Maton API key

It sits in Backend & APIs, covering Microservices, Pull requests and OAuth and OpenID Connect. It works with GitHub. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

Users want to interact with GitHub repositories
Manage issues and PRs
Automate workflows

Example prompts

“/github-api”

Requirements

Python 3
A credential in MATON_API_KEY
A credential in YOUR_API_KEY
Compatibility (from SKILL.md): Requires network access and valid Maton API key

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- gateway.maton.ai
- ctrl.maton.ai
- connect.maton.ai
Also links to:
- docs.github.com
- maton.ai
- discord.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- MATON_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires network access and valid Maton API key
From compatibility in the SKILL.md frontmatter.

Context cost

GitHub API loads about 3.9k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 698 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~88
When it runs · the whole SKILL.md, loaded when a task matches: ~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 698 words, ~3,929 tokens.

Download SKILL.mdSave it as .claude/skills/github-api/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.

name: github-api
description: GitHub API integration with managed OAuth. Access repositories, issues, pull requests, commits, branches, and users. Use this skill when users want to interact with GitHub repositories, manage issues and PRs, search code, or automate workflows. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility: Requires network access and valid Maton API key
metadata.author: maton
metadata.version: 1.0

GitHub

Access the GitHub REST API with managed OAuth authentication. Manage repositories, issues, pull requests, commits, branches, users, and more.

Quick Start

bash

# Get authenticated user
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/github/user')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/github/{native-api-path}

Replace {native-api-path} with the actual GitHub API endpoint path. The gateway proxies requests to api.github.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

bash

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your GitHub OAuth connections at https://ctrl.maton.ai.

List Connections

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=github&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

bash

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'github'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

json

{
  "connection": {
    "connection_id": "83e7c665-60f6-4a64-816c-5e287ea8982f",
    "status": "ACTIVE",
    "creation_time": "2026-02-06T03:00:43.860014Z",
    "last_updated_time": "2026-02-06T03:01:06.027323Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "github",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple GitHub connections, specify which one to use with the Maton-Connection header:

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/github/user')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '83e7c665-60f6-4a64-816c-5e287ea8982f')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Users

Get Authenticated User

bash

GET /github/user

Get User by Username

bash

GET /github/users/{username}

List Users

bash

GET /github/users?since={user_id}&per_page=30

Repositories

List User Repositories

bash

GET /github/user/repos?per_page=30&sort=updated

Query parameters: type (all, owner, public, private, member), sort (created, updated, pushed, full_name), direction (asc, desc), per_page, page

List Organization Repositories

bash

GET /github/orgs/{org}/repos?per_page=30

Get Repository

bash

GET /github/repos/{owner}/{repo}

Create Repository (User)

bash

POST /github/user/repos
Content-Type: application/json

{
  "name": "my-new-repo",
  "description": "A new repository",
  "private": true,
  "auto_init": true
}

Create Repository (Organization)

bash

POST /github/orgs/{org}/repos
Content-Type: application/json

{
  "name": "my-new-repo",
  "description": "A new repository",
  "private": true
}

Update Repository

bash

PATCH /github/repos/{owner}/{repo}
Content-Type: application/json

{
  "description": "Updated description",
  "has_issues": true,
  "has_wiki": false
}

Delete Repository

bash

DELETE /github/repos/{owner}/{repo}

Repository Contents

List Contents

bash

GET /github/repos/{owner}/{repo}/contents/{path}

Get File Contents

bash

GET /github/repos/{owner}/{repo}/contents/{path}?ref={branch}

Create or Update File

bash

PUT /github/repos/{owner}/{repo}/contents/{path}
Content-Type: application/json

{
  "message": "Create new file",
  "content": "SGVsbG8gV29ybGQh",
  "branch": "main"
}

Note: content must be Base64 encoded.

Delete File

bash

DELETE /github/repos/{owner}/{repo}/contents/{path}
Content-Type: application/json

{
  "message": "Delete file",
  "sha": "{file_sha}",
  "branch": "main"
}

Branches

List Branches

bash

GET /github/repos/{owner}/{repo}/branches?per_page=30

Get Branch

bash

GET /github/repos/{owner}/{repo}/branches/{branch}

Rename Branch

bash

POST /github/repos/{owner}/{repo}/branches/{branch}/rename
Content-Type: application/json

{
  "new_name": "new-branch-name"
}

Merge Branches

bash

POST /github/repos/{owner}/{repo}/merges
Content-Type: application/json

{
  "base": "main",
  "head": "feature-branch",
  "commit_message": "Merge feature branch"
}

Commits

List Commits

bash

GET /github/repos/{owner}/{repo}/commits?per_page=30

Query parameters: sha (branch name or commit SHA), path (file path), author, committer, since, until, per_page, page

Get Commit

bash

GET /github/repos/{owner}/{repo}/commits/{ref}

Compare Two Commits

bash

GET /github/repos/{owner}/{repo}/compare/{base}...{head}

Issues

List Repository Issues

bash

GET /github/repos/{owner}/{repo}/issues?state=open&per_page=30

Query parameters: state (open, closed, all), labels, assignee, creator, mentioned, sort, direction, since, per_page, page

Get Issue

bash

GET /github/repos/{owner}/{repo}/issues/{issue_number}

Create Issue

bash

POST /github/repos/{owner}/{repo}/issues
Content-Type: application/json

{
  "title": "Found a bug",
  "body": "Bug description here",
  "labels": ["bug"],
  "assignees": ["username"]
}

Update Issue

bash

PATCH /github/repos/{owner}/{repo}/issues/{issue_number}
Content-Type: application/json

{
  "state": "closed",
  "state_reason": "completed"
}

Lock Issue

bash

PUT /github/repos/{owner}/{repo}/issues/{issue_number}/lock
Content-Type: application/json

{
  "lock_reason": "resolved"
}

Unlock Issue

bash

DELETE /github/repos/{owner}/{repo}/issues/{issue_number}/lock

Issue Comments

List Issue Comments

bash

GET /github/repos/{owner}/{repo}/issues/{issue_number}/comments?per_page=30

Create Issue Comment

bash

POST /github/repos/{owner}/{repo}/issues/{issue_number}/comments
Content-Type: application/json

{
  "body": "This is a comment"
}

Update Issue Comment

bash

PATCH /github/repos/{owner}/{repo}/issues/comments/{comment_id}
Content-Type: application/json

{
  "body": "Updated comment"
}

Delete Issue Comment

bash

DELETE /github/repos/{owner}/{repo}/issues/comments/{comment_id}

Labels

List Labels

bash

GET /github/repos/{owner}/{repo}/labels?per_page=30

Create Label

bash

POST /github/repos/{owner}/{repo}/labels
Content-Type: application/json

{
  "name": "priority:high",
  "color": "ff0000",
  "description": "High priority issues"
}

Milestones

List Milestones

bash

GET /github/repos/{owner}/{repo}/milestones?state=open&per_page=30

Create Milestone

bash

POST /github/repos/{owner}/{repo}/milestones
Content-Type: application/json

{
  "title": "v1.0",
  "state": "open",
  "description": "First release",
  "due_on": "2026-03-01T00:00:00Z"
}

Pull Requests

List Pull Requests

bash

GET /github/repos/{owner}/{repo}/pulls?state=open&per_page=30

Query parameters: state (open, closed, all), head, base, sort, direction, per_page, page

Get Pull Request

bash

GET /github/repos/{owner}/{repo}/pulls/{pull_number}

Create Pull Request

bash

POST /github/repos/{owner}/{repo}/pulls
Content-Type: application/json

{
  "title": "New feature",
  "body": "Description of changes",
  "head": "feature-branch",
  "base": "main",
  "draft": false
}

Update Pull Request

bash

PATCH /github/repos/{owner}/{repo}/pulls/{pull_number}
Content-Type: application/json

{
  "title": "Updated title",
  "state": "closed"
}

List Pull Request Commits

bash

GET /github/repos/{owner}/{repo}/pulls/{pull_number}/commits?per_page=30

List Pull Request Files

bash

GET /github/repos/{owner}/{repo}/pulls/{pull_number}/files?per_page=30

Check If Merged

bash

GET /github/repos/{owner}/{repo}/pulls/{pull_number}/merge

Merge Pull Request

bash

PUT /github/repos/{owner}/{repo}/pulls/{pull_number}/merge
Content-Type: application/json

{
  "commit_title": "Merge pull request",
  "merge_method": "squash"
}

Merge methods: merge, squash, rebase

Pull Request Reviews

List Reviews

bash

GET /github/repos/{owner}/{repo}/pulls/{pull_number}/reviews?per_page=30

Create Review

bash

POST /github/repos/{owner}/{repo}/pulls/{pull_number}/reviews
Content-Type: application/json

{
  "body": "Looks good!",
  "event": "APPROVE"
}

Events: APPROVE, REQUEST_CHANGES, COMMENT

Search

Search Repositories

bash

GET /github/search/repositories?q={query}&per_page=30

Example queries:

tetris+language:python - Repositories with "tetris" in Python
react+stars:>10000 - Repositories with "react" and 10k+ stars

Search Issues

bash

GET /github/search/issues?q={query}&per_page=30

Example queries:

bug+is:open+is:issue - Open issues containing "bug"
author:username+is:pr - Pull requests by author

Search Code

bash

GET /github/search/code?q={query}&per_page=30

Example queries:

addClass+repo:facebook/react - Search for "addClass" in a specific repo
function+extension:js - JavaScript functions

Note: Code search may timeout on broad queries.

Search Users

bash

GET /github/search/users?q={query}&per_page=30

Organizations

List User Organizations

bash

GET /github/user/orgs?per_page=30

Note: Requires read:org scope.

Show full SKILL.md (279 more words)Show less

Get Organization

bash

GET /github/orgs/{org}

List Organization Members

bash

GET /github/orgs/{org}/members?per_page=30

Rate Limit

Get Rate Limit

bash

GET /github/rate_limit

Response:

json

{
  "rate": {
    "limit": 5000,
    "remaining": 4979,
    "reset": 1707200000
  },
  "resources": {
    "core": { "limit": 5000, "remaining": 4979 },
    "search": { "limit": 30, "remaining": 28 }
  }
}

Pagination

GitHub uses page-based and link-based pagination:

bash

GET /github/repos/{owner}/{repo}/issues?per_page=30&page=2

Response headers include pagination links:

Link: <url>; rel="next", <url>; rel="last"

Common pagination parameters:

per_page: Results per page (max 100, default 30)
page: Page number (default 1)

Some endpoints use cursor-based pagination with since parameter (e.g., listing users).

Code Examples

JavaScript

javascript

const response = await fetch(
  'https://gateway.maton.ai/github/repos/owner/repo/issues?state=open&per_page=10',
  {
    headers: {
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    }
  }
);
const issues = await response.json();

Python

python

import os
import requests

response = requests.get(
    "https://gateway.maton.ai/github/repos/owner/repo/issues",
    headers={"Authorization": f"Bearer {os.environ['MATON_API_KEY']}"},
    params={"state": "open", "per_page": 10},
)
issues = response.json()

Notes

Repository names are case-insensitive but the API preserves case
Issue numbers and PR numbers share the same sequence per repository
Content must be Base64 encoded when creating/updating files
Rate limits: 5000 requests/hour for authenticated users, 30 searches/minute
Search queries may timeout on very broad patterns
Some endpoints require specific OAuth scopes (e.g., read:org for organization operations). If you receive a scope error, contact Maton support at support@maton.ai with the specific operations/APIs you need and your use-case
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments

Error Handling

Status	Meaning
400	Missing GitHub connection
401	Invalid or missing Maton API key
403	Forbidden - insufficient permissions or scope
404	Resource not found
408	Request timeout (common for complex searches)
422	Validation failed
429	Rate limited
4xx/5xx	Passthrough error from GitHub API

Troubleshooting: API Key Issues

Check that the MATON_API_KEY environment variable is set:

bash

echo $MATON_API_KEY

Verify the API key is valid by listing connections:

bash

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Troubleshooting: Invalid App Name

Ensure your URL path starts with github. For example:

Correct: https://gateway.maton.ai/github/user
Incorrect: https://gateway.maton.ai/api.github.com/user

Resources

Files

SKILL.md and 3 other files in skills/github-api of CraftOS-dev/CraftBot.

SKILL.md
.clawhub/origin.json
LICENSE.txt
_meta.json

Open the folder on GitHubat commit b50970c

Compare with similar skills

GitHub API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

GitHub API compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
GitHub API this skillCraftOS-dev/CraftBot	392	—	~3.9k	Automated safety check: Pass	MIT	today
OneCLI Gatewaynanocoai/nanoclaw	31k	—	~856	Automated safety check: Pass	MIT	yesterday
Active CampaignLeoYeAI/openclaw-master-skills	2.2k	—	~4.1k	Automated safety check: Pass	MIT	2 mo ago
Acuity SchedulingLeoYeAI/openclaw-master-skills	2.2k	—	~4.1k	Automated safety check: Pass	MIT	2 mo ago
BrevoLeoYeAI/openclaw-master-skills	2.2k	—	~4.8k	Automated safety check: Pass	MIT	2 mo ago
ClickfunnelsLeoYeAI/openclaw-master-skills	2.2k	—	~4.2k	Automated safety check: Pass	MIT	2 mo ago

Similar skills

OneCLI Gateway
nanocoai/nanoclaw
Explains how to call external APIs through the OneCLI proxy, which injects stored credentials into outgoing HTTPS requests so the agent never handles keys.
31k GitHub stars~856 tokensUpdated yesterday
Backend & APIsAuto-check passed
Active Campaign
LeoYeAI/openclaw-master-skills
ActiveCampaign API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Acuity Scheduling
LeoYeAI/openclaw-master-skills
Acuity Scheduling API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Brevo
LeoYeAI/openclaw-master-skills
Brevo API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Clickfunnels
LeoYeAI/openclaw-master-skills
ClickFunnels API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Confluence
LeoYeAI/openclaw-master-skills
Confluence API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed

Questions about GitHub API

What does GitHub API do?

GitHub API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot. GitHub API is an agent skill from CraftOS-dev/CraftBot. GitHub API integration with managed OAuth.

When should I use GitHub API?

GitHub API fits situations like: users want to interact with GitHub repositories; manage issues and PRs; automate workflows.

How do I install GitHub API in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill github-api -a claude-code`. Or copy the skill folder (skills/github-api in CraftOS-dev/CraftBot) into .claude/skills/github-api in your project. Claude Code loads it when a task matches its description.

How do I install GitHub API in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill github-api -a codex`. Or copy the skill folder (skills/github-api in CraftOS-dev/CraftBot) into .agents/skills/github-api in your project. Codex loads it when a task matches its description.

Can I use GitHub API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CraftOS-dev/CraftBot --skill github-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/github-api, .gemini/skills/github-api, .github/skills/github-api and .opencode/skills/github-api in your project.

What does GitHub API need to run?

Going by SKILL.md and its folder, GitHub API needs the command-line tools its instructions call (python and curl) and credentials named MATON_API_KEY. Our summary lists: Python 3; A credential in MATON_API_KEY; A credential in YOUR_API_KEY. Compatibility (from SKILL.md): Requires network access and valid Maton API key.

Does GitHub API access the network?

SKILL.md names 6 domains. In commands or code: gateway.maton.ai, ctrl.maton.ai and connect.maton.ai; the agent is likely to contact these when it follows the instructions. As links in the text: docs.github.com, maton.ai and discord.com. This is read from the text; nothing was executed.

Is GitHub API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does GitHub API use?

GitHub API is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does GitHub API use?

About 3.9k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to GitHub API?

Skills that share tags, products or a category with GitHub API: OneCLI Gateway (nanocoai/nanoclaw, 31k stars), Active Campaign (LeoYeAI/openclaw-master-skills, 2.2k stars), Acuity Scheduling (LeoYeAI/openclaw-master-skills, 2.2k stars) and Brevo (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GitHub API?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

Source: CraftOS-dev/CraftBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install GitHub API

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

GitHub

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

Users

Get Authenticated User

Get User by Username

List Users

Repositories

List User Repositories

List Organization Repositories

Get Repository

Create Repository (User)

Create Repository (Organization)

Update Repository

Delete Repository

Repository Contents

List Contents

Get File Contents

Create or Update File

Delete File

Branches

List Branches

Get Branch

Rename Branch

Merge Branches

Commits

List Commits

Get Commit

Compare Two Commits

Issues

List Repository Issues

Get Issue

Create Issue

Update Issue

Lock Issue

Unlock Issue

Issue Comments

List Issue Comments

Create Issue Comment

Update Issue Comment

Delete Issue Comment

Labels

List Labels

Create Label

Milestones

List Milestones

Create Milestone

Pull Requests

List Pull Requests

Get Pull Request

Create Pull Request

Update Pull Request

List Pull Request Commits

List Pull Request Files