Agent skill

Gh Skills Sync

by akiojin in akiojin/unity-cli

Sync the gh- automation skills from the upstream skills repository into Codex and project skill directories.

MITAuto-check: notesGame Development

Install Gh Skills Sync

skills CLI
$ npx skills add akiojin/unity-cli --skill gh-skills-sync -a claude-code

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

GitHub CLI
$ gh skill install akiojin/unity-cli gh-skills-sync --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/akiojin/unity-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/dev-skills/gh-skills-sync .claude/skills/gh-skills-sync && 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/

Facts

Skill name
gh-skills-sync
GitHub stars
108
Token cost
~680 tokens
SKILL.md length
269 words
Files
2 (incl. references)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Sync the gh- automation skills from the upstream skills repository into Codex and project skill directories.

  • Works in 4 steps: Run --check first when the user only… → Decide whether to target project skills,… → Run the sync command with any required… → …
  • The user asks to refresh
  • SKILL.md covers Use When, Do Not Use When, Recommended Flow and Command, plus 4 more sections
  • Calls git

What it does

Gh Skills Sync is an agent skill from akiojin/unity-cli. Sync the gh- automation skills from the upstream skills repository into Codex and project skill directories. Use when the user asks to refresh, check, or pin gh-fix-ci, gh-fix-issue, gh-pr, or gh-pr-check in this repo or the global Codex install. Do not use for updating unity-cli workflow skills; edit those skill folders directly.

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/sync-behavior.md`).

It sits in Game Development, covering Failing and flaky tests. The repository describes itself as: Rust CLI for Unity Editor automation over Unity TCP protocol. The licence is MIT.

When your agent uses it

  • The user asks to refresh
  • Gh-pr-check in this repo
  • The global Codex install
  • Updating unity-cli workflow skills

Example prompts

  • “/gh-skills-sync”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob

Workflow steps

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

  1. Run --check first when the user only asked for status or when the current state is unclear.
  2. Decide whether to target project skills, global skills, or both.
  3. Run the sync command with any required --ref.
  4. Re-run --check after changes and report what moved.

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gh Skills Sync loads about 680 tokens when it runs, and up to ~834 if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 269 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~680
With references · SKILL.md plus every file in references/, read only if the agent opens them
~834

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob

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 akiojin/unity-cli at commit 7f45d7a, republished under its MIT licence (© akiojin). 269 words, ~680 tokens.

Download SKILL.mdSave it as .claude/skills/gh-skills-sync/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
gh-skills-sync
description
Sync the gh-* automation skills from the upstream skills repository into Codex and project skill directories. Use when the user asks to refresh, check, or pin `gh-fix-ci`, `gh-fix-issue`, `gh-pr`, or `gh-pr-check` in this repo or the global Codex install. Do not use for updating unity-cli workflow skills; edit those skill folders directly.
allowed-tools
Bash, Read, Grep, Glob
metadata.author
akiojin
metadata.version
0.2.0
metadata.category
maintenance

gh-skills-sync

Use this skill when asked to update or synchronize GitHub-related skills:

  • gh-fix-ci
  • gh-fix-issue
  • gh-pr
  • gh-pr-check

Read references/sync-behavior.md when you need details about source selection, backup behavior, or project-vs-global targeting.

Use When

  • The user wants to refresh the local copy of the gh-* automation skills.
  • The task is to check whether project and global copies are in sync.
  • The user wants to pin synchronization to a specific upstream ref.

Do Not Use When

  • The task is about editing unity-cli skills in .claude-plugin/plugins/unity-cli/skills.
  • The request is to use a gh-* skill rather than sync it.
  1. Run --check first when the user only asked for status or when the current state is unclear.
  2. Decide whether to target project skills, global skills, or both.
  3. Run the sync command with any required --ref.
  4. Re-run --check after changes and report what moved.

Command

Run from repository root:

bash
scripts/sync-gh-skills.sh

Typical Options

bash
# check only (no write)
scripts/sync-gh-skills.sh --check

# update project skills only
scripts/sync-gh-skills.sh --target project

# pin a specific ref
scripts/sync-gh-skills.sh --ref main

Examples

  • "Check whether our local gh-* skills are behind upstream."
  • "Update only the project copy of the GitHub automation skills."
  • "Sync the gh-* skills from a pinned upstream ref."

Behavior

  • Default source repo: akiojin/skills
  • Sync targets:
    • Global: ${CODEX_HOME:-~/.codex}/skills
    • Project: ./.codex/skills
  • Existing destination skill directories are backed up under .backup/gh-sync-<timestamp>/.
  • Fetch method is automatic:
    • Prefer skill-installer if available.
    • Fallback to git sparse-checkout so it also works in Claude Code environments.

Common Issues

  • The wrong target was updated: use --target project or the appropriate target selector before syncing.
  • The user only wanted a dry check: start with --check.
  • Updated skills do not appear immediately: restart Codex or Claude Code after the sync.
  • Use scripts/sync-gh-skills.sh --check after any update to verify consistency.

© akiojin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in dev-skills/gh-skills-sync of akiojin/unity-cli.

  • SKILL.md
  • references/sync-behavior.md

Open the folder on GitHubat commit 7f45d7a

Compare with similar skills

Gh Skills Sync 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.

Gh Skills Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gh Skills Sync this skillakiojin/unity-cli108—~680Automated safety check: NotesMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Pester Failure AnalysisPowerShell/PowerShell56k—~5.1kAutomated safety check: PassMIT
Cucumber and Playwright E2E Testslanggenius/dify158k—~682Automated safety check: PassCustom licence
Systematic Debuggingultralisp/ultralisp25852 repos~2.4kAutomated safety check: PassNone
Perf ComparisonClickHouse/ClickHouse50k—~3.9kAutomated safety check: NotesApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Pester Failure Analysis

    PowerShell/PowerShell

    Investigates failing Pester tests in PowerShell CI jobs by following a six-step workflow from pull request status to documented fix recommendations.

    56k GitHub stars~5.1k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Guides changes and reviews of the Cucumber and Playwright end-to-end suite under `e2e/`: feature files, step definitions, support code, tags, locators and assertions.

    158k GitHub stars~682 tokensUpdated today
    Testing & QAAuto-check passed
  • Systematic Debugging

    ultralisp/ultralisp

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    258 GitHub starsUsed in 52 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Perf Comparison

    ClickHouse/ClickHouse

    Evaluate ClickHouse performance test results from existing CI/dashboard data or local perf.py runs.

    50k GitHub stars~3.9k tokensUpdated today
    DatabasesAuto-check: notes
  • Investigates a stubbornly failing Playwright test as a possible product bug, using error output, screenshots, traces and server code, and writes a structured bug report.

    41k GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from akiojin/unity-cli

All 28 skills in this repo
  • Gh PR

    akiojin/unity-cli

    Create or update GitHub Pull Requests with the gh CLI, including deciding whether to create a new PR or only push based on existing PR merge status.

    108 GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check passed
  • Unity 2D Sprite Tilemap

    akiojin/unity-cli

    Build and verify a 2D sprite and Tilemap scene with unity-cli.

    108 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Unity Addressables

    akiojin/unity-cli

    Manage Unity Addressables groups and content with unity-cli.

    108 GitHub stars~700 tokensUpdated 2 days ago
    Auto-check passed
  • Unity Asset Management

    akiojin/unity-cli

    Manage Unity assets and import metadata with unity-cli. An agent skill from akiojin/unity-cli.

    108 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Unity Audio Setup

    akiojin/unity-cli

    Configure Unity audio with unity-cli. An agent skill from akiojin/unity-cli.

    108 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Unity Csharp Edit

    akiojin/unity-cli

    Implement, fix, and refactor Unity C code with unity-cli write tools.

    108 GitHub stars~979 tokensUpdated 2 days ago
    Auto-check passed

Questions about Gh Skills Sync

What does Gh Skills Sync do?

Sync the gh- automation skills from the upstream skills repository into Codex and project skill directories. Gh Skills Sync is an agent skill from akiojin/unity-cli. Sync the gh- automation skills from the upstream skills repository into Codex and project skill directories.

When should I use Gh Skills Sync?

Gh Skills Sync fits situations like: the user asks to refresh; gh-pr-check in this repo; the global Codex install; updating unity-cli workflow skills.

How do I install Gh Skills Sync in Claude Code?

Run `npx skills add akiojin/unity-cli --skill gh-skills-sync -a claude-code`. Or copy the skill folder (dev-skills/gh-skills-sync in akiojin/unity-cli) into .claude/skills/gh-skills-sync in your project. Claude Code loads it when a task matches its description.

How do I install Gh Skills Sync in Codex?

Run `npx skills add akiojin/unity-cli --skill gh-skills-sync -a codex`. Or copy the skill folder (dev-skills/gh-skills-sync in akiojin/unity-cli) into .agents/skills/gh-skills-sync in your project. Codex loads it when a task matches its description.

Can I use Gh Skills Sync 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 akiojin/unity-cli --skill gh-skills-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gh-skills-sync, .gemini/skills/gh-skills-sync, .github/skills/gh-skills-sync and .opencode/skills/gh-skills-sync in your project.

What does Gh Skills Sync need to run?

Going by SKILL.md and its folder, Gh Skills Sync needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob.

Does Gh Skills Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gh Skills Sync safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Gh Skills Sync use?

Gh Skills Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gh Skills Sync use?

About 680 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 154 tokens, read only when the agent opens those files.

What are the alternatives to Gh Skills Sync?

Skills that share tags, products or a category with Gh Skills Sync: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Pester Failure Analysis (PowerShell/PowerShell, 56k stars), Cucumber and Playwright E2E Tests (langgenius/dify, 158k stars) and Systematic Debugging (ultralisp/ultralisp, 258 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gh Skills Sync?

akiojin (a GitHub user) maintains it in akiojin/unity-cli, which has 108 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 9, 2026.

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