English | 简体中文

Sync Skill to GitHub

A Codex Skill for safely publishing an installed, user-owned Skill to GitHub and synchronizing later local updates to the same repository.

Capabilities

• Publish a Skill to a personal account or GitHub organization.
• Verify Git, GitHub CLI, authentication, ownership, and repository access.
• Detect sensitive files before every push.
• Support constrained networks with connectivity checks and trusted Homebrew mirrors.
• Remember the repository binding for later synchronization.
• Stop on remote changes instead of force-pushing or overwriting work.
• Generate and maintain bilingual repository documentation and license files.

Install

Clone the repository into your Codex Skills directory:

git clone https://github.com/Unmoored-Lab/sync-skill-to-github.git ~/.codex/skills/sync-skill-to-github

Update

Ask Codex to update the installed Skill safely:

Use $sync-skill-to-github to update itself from GitHub.

For a Git-based installation, the Skill verifies the repository origin and requires a clean working tree before running a fast-forward-only pull. You can also update it manually:

cd ~/.codex/skills/sync-skill-to-github
git pull --ff-only

For a manually copied installation, ask Codex to update it. The Skill downloads and validates the latest version, shows which installed files will change, and asks before replacing them.

Use

Ask Codex:

Use $sync-skill-to-github to publish one of my installed Skills to GitHub.

For later updates:

Use $sync-skill-to-github to sync my Skill to GitHub.

The Skill requests confirmation before creating a repository or pushing changes. It never requests a GitHub password or force-pushes.

Repository contents

• SKILL.md: publishing, synchronization, and safety workflow.
• agents/openai.yaml: Codex UI metadata.
• README.md: default English repository documentation.
• README.zh-CN.md: Simplified Chinese repository documentation.
• LICENSE: MIT License.

License

MIT © 2026 Unmoored-Lab