Agent Skills › nixopus/nixopus › github-onboarding

github-onboarding

GitHub

引导用户完成 GitHub 连接配置，区分云和自托管模式安装或创建 GitHub App，确保在部署前建立有效连接。

api/skills/github-onboarding/SKILL.md nixopus/nixopus

Trigger Scenarios

get_github_connectors 返回空值缺少有效的 GitHub 连接器需要初始化 GitHub 集成

Install

npx skills add nixopus/nixopus --skill github-onboarding -g -y

More Options

Non-standard path

npx skills add https://github.com/nixopus/nixopus/tree/master/api/skills/github-onboarding -g -y

Use without installing

npx skills use nixopus/nixopus@github-onboarding

指定 Agent (Claude Code)

npx skills add nixopus/nixopus --skill github-onboarding -a claude-code -g -y

安装 repo 全部 skill

npx skills add nixopus/nixopus --all -g -y

预览 repo 内 skill

npx skills add nixopus/nixopus --list

SKILL.md

Frontmatter

{
    "name": "github-onboarding",
    "metadata": {
        "version": "1.0"
    },
    "description": "Guide users through connecting GitHub to Nixopus when no GitHub connector exists. Covers GitHub App installation for cloud users and GitHub App manifest setup for self-hosted users."
}

GitHub Onboarding

Use this when get_github_connectors returns empty or has no valid connectors. Do NOT continue the deploy flow or call get_github_repositories until the user has completed the GitHub connection.

Cloud Users

Guide the user step by step:

Install the Nixopus GitHub App: https://github.com/apps/nixopus/installations/new
- For an organization: https://github.com/organizations/{org-name}/settings/apps/nixopus/installations/new
Select which repositories or the entire organization to grant access to.
After clicking Install, GitHub redirects back to Nixopus and the connection is saved automatically.
Once connected, come back and say "deploy my app" — Nixopus will list the repos and walk through deployment.

Self-Hosted Users

Self-hosted users need to create their own GitHub App first:

Open the Nixopus dashboard and go to the Apps page.
The setup wizard will walk through creating a GitHub App using GitHub's app manifest flow.
Choose whether to create the app under a personal account or an organization.
After creating the app, install it on the desired repositories.
Once setup completes, come back and say "deploy my app" — Nixopus will list the repos and walk through deployment.

Important

Do NOT attempt get_github_repositories, analyze_repository, or any deploy steps until the connection is set up.
NEVER ask the user whether they are on cloud or self-hosted. The [user-context] block always contains instance: mode=cloud or instance: mode=self-hosted. Use that directly. If mode is "cloud", give cloud steps. If mode is "self-hosted", give self-hosted steps.
After the user says they've connected, call get_github_connectors again to verify before proceeding.