skills.rest
ceedaragents
ceedaragentsOFFICIAL
Explore all skills by this author →
GitHub

cyrus-setup-github

Configures GitHub CLI authentication, git identity, and an optional GitHub App with webhooks for Cyrus.

794|163|Updated Apr 19, 2025
Search Tags:#Webhooks#gitHub#cli authentication#Pull Requests#GitHub App#cyrus#git config
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-github
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cyrus-setup-github
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-github
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-github

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up GitHub integration for an AI coding agent involves many error-prone manual steps: authenticating the gh CLI, configuring git identity, creating a GitHub App with the right permissions, exchanging manifest codes for credentials, and installing the app on repositories. This Skill automates that entire flow so Cyrus can create branches, commits, and pull requests, and optionally respond to @mentions in PR comments.

Core Features & Use Cases

  • Outbound Git Setup: Authenticates the GitHub CLI (gh auth login) and configures git user name and email so Cyrus can create branches, commits, and pull requests.
  • GitHub App Creation via Manifest Flow: Builds a manifest JSON, serves a local helper page, and exchanges the one-time code for app credentials (app ID, webhook secret, private key) written securely to ~/.cyrus/.env.
  • Webhook & Mention Support: Enables Cyrus to receive PR comments and reviews via webhooks, respond to @mentions, and act on changes-requested reviews, with guidance on the GitHub autocomplete username quirk.
  • Use Case: After installing Cyrus, run this Skill to connect your GitHub account, create a "Cyrus" GitHub App on your organization, install it on your repositories, and have the agent respond when you type @cyrus in a PR comment.

Quick Start

Ask your AI agent to run the cyrus-setup-github skill to configure GitHub CLI authentication and optionally create a GitHub App for PR mention responses.

Frequently Asked Questions about cyrus-setup-github

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure GitHub for the Cyrus AI agent?▼

Run the cyrus-setup-github skill, which authenticates the gh CLI, sets your git user name and email, and optionally creates a GitHub App for webhooks. Credentials are written to ~/.cyrus/.env and the private key to ~/.cyrus/github-app.pem.

How do I create a GitHub App using the manifest flow?▼

The skill builds a manifest JSON with permissions and webhook URL, serves a local HTML form that POSTs it to GitHub's app creation URL, then exchanges the returned one-time code via the /app-manifests/<CODE>/conversions endpoint for the app ID, webhook secret, and private key.

Why doesn't my GitHub App bot name autocomplete in PR comments?▼

GitHub's autocomplete only suggests real user accounts, not App bots. The workaround is to create a GitHub user account with the same name, add it as a collaborator, and set GITHUB_BOT_USERNAME to that username. Mentions still work if typed manually without this.

Can Cyrus respond to @mentions in pull request comments?▼

Yes, if you enable the optional webhook setup. The skill creates a GitHub App subscribed to issue_comment, pull_request_review, and pull_request_review_comment events, so Cyrus responds when its bot username is mentioned.

What permissions does the Cyrus GitHub App need?▼

The manifest requests write access to contents, issues, pull requests, and repository hooks. These permissions let Cyrus push branches, comment on PRs, and manage webhooks on installed repositories.

Why does the GitHub webhook show delivery failures during setup?▼

The webhook URL only responds once Cyrus is actually running. Delivery failures during setup are expected, and GitHub will retry deliveries automatically after the Cyrus process starts.

Related Skills

Explore More Software Engineering Skills→
Minara-AIMinara-AI
6

media-setup

Configure platform connections, API keys, and environment dependencies for media-agent installations.

Official
Advanced
kevinrobaynakevinrobayna

review-prs

Automates GitHub pull request review via isolated git worktrees and consolidated comments.

Community
Advanced
moltis-orgmoltis-org
2.8k

webhook-subscriptions

Create webhook subscriptions that trigger Moltis agent runs from external services.

Official
Intermediate
pikkujspikkujs
56

pikku-config

Centralize secrets, environment variables, and OAuth2 credentials for Pikku apps.

Official
Intermediate