Codex Skills

This repository is the canonical mirror of my Codex skills root directory.

The repository root maps directly to each machine's $CODEX_HOME/skills directory:

• Windows: C:\Users\<user>\.codex\skills
• macOS: ~/.codex/skills
• Linux: ~/.codex/skills

Sync Model

• main is the single source of truth.
• macOS, Windows, and Linux should keep the same directory tree.
• Add, remove, or update skills in this repository first, then sync other machines.
• Do not maintain separate per-platform branches or win/, mac/, linux/ subdirectories.

Platform-specific behavior should stay inside a skill when needed, for example by shipping multiple scripts in the same skill directory.

Recommended Sync

First-time setup

Clone this repository directly into the Codex skills directory for that machine.

git clone https://github.com/jacketlong23/skills.git "$CODEX_HOME/skills"

If the target directory already exists, clone elsewhere first and then copy the missing skill directories into place.

Existing machine

Pull the latest changes:

git -C "$CODEX_HOME/skills" pull --ff-only

GitHub web workflow

If you prefer using the GitHub web UI as the distribution surface:

• treat this repository as the source of truth
• keep the repository root identical to the local skills root
• make changes in the repo first, then sync them to other machines

Do not let one machine accumulate local-only skills for long periods without pushing them back here.

Repository Rules

• Keep all skill directories at the repository root.
• Keep .system in the repository.
• Ignore cache, local auth, and OS noise files only.
• Do not add an extra top-level skills/ folder.

Notes

• This repository is intended for cross-machine sync, not platform-specific customization.
• If a skill is only commonly used on one platform, it can still live here as long as it does not break loading on the others.