A practical bundle of Codex skills for people who want their agents to get better at repeated work instead of rediscovering the same procedure every time.
This repository collects field-tested skills that make Codex more useful for long-lived project work: source capture, writing cleanup, PDF and video review, local Codex maintenance, workspace recovery, and structured idea critique.
| Skill | Use It When |
|---|---|
codex-history-repair |
Codex tasks lose visible history, fail to resume after provider switching, or report encrypted-content, paginated-projection, or lineage cutoff errors. |
find-skills |
You want Codex to scout local and ecosystem skills before improvising or installing anything. |
humanize-writing |
You want prose edited to sound more natural while preserving meaning, facts, citations, and voice. |
keep-codex-fast |
Codex feels slow, sessions/logs/worktrees/backups have grown, or you want report-first maintenance with verified archival, compression, and restore tooling. |
pdf |
You need Codex to read, create, inspect, or visually verify PDF files. |
seppuku |
A Codex thread should deliberately self-archive when explicitly told to retire. |
source-intake |
An inbound source should be captured with provenance, sensitivity, interpretation, and justified propagation. |
startup-pressure-test |
You want a startup idea evaluated directly for customer pain, proof, positioning, risks, and next tests. |
storyboard-review |
You need to compare a video render against a storyboard, script, shot list, narration plan, or production brief. |
thread-workspace-relink |
Codex threads point at old project paths after folders were moved or renamed. |
video-perception |
You want Codex to inspect or summarize video content through the Codex video-vision workflow. |
Three skills cover distinct local Codex failure modes without treating every problem as generic cache cleanup:
| Symptom | Start With | What It Protects |
|---|---|---|
| Encrypted-content errors, missing paginated turns, stale lineage offsets, or history that vanishes after switching providers | codex-history-repair |
Preserves visible and tool records, stashes removed encrypted reasoning, backs up the rollout and databases, and rebuilds derived history through Codex's own migration path. |
| Slow startup, oversized thread metadata, accumulated closed subagents, stale worktrees, large logs, or oversized backup collections | keep-codex-fast |
Reports first, archives instead of deleting, backs up before applying, and provides verified restore, cold-storage, and backup-compression helpers. |
| Existing tasks still point at a project folder after it was moved or renamed | thread-workspace-relink |
Rewrites only structured working-directory state, supports one or many task IDs, and creates a timestamped backup before applying. |
These are unofficial local recovery tools, not replacements for upstream Codex fixes. Start with the dry-run or report mode, review the exact candidates, and keep generated backups private. codex-history-repair includes a lifecycle wrapper that quits Codex, stops its app-server daemon, pauses a running Threadripper watcher, verifies closed database handles, restores the watcher on every exit, and reopens Codex only after a successful repair.
- Clean up Codex safely: run
keep-codex-fastin report mode, inspect what would be archived, then apply only after backups and restore commands are generated. - Turn a source into project context: use
source-intaketo capture a screenshot, article, paper, or post; separate facts from interpretation; then decide whether it belongs in a board item, project doc, skill, or reference file. - Review a video against intent: use
video-perceptionto inspect a render, thenstoryboard-reviewto compare it against the original plan. - Recover after reorganizing projects: use
thread-workspace-relinkwhen old Codex threads still point at moved folders. - Repair broken task history: use
codex-history-repairto diagnose encrypted reasoning, stale lineage offsets, and missing paginated projections with backup-first one-task helpers and a provider-switch sanitizer. - Improve a draft without sanding off the author: use
humanize-writingwhen the text is accurate but sounds too generic or machine-shaped.
Install through the open Agent Skills CLI:
npx skills add EyrieCommander/codex-skillsBrowse the indexed bundle and individual skill install counts at skills.sh/eyriecommander/codex-skills.
From the repo root, install the ready bundle into your local Codex skills directory:
sh scripts/install.shThe installer adds missing bundled skills automatically. If a skill already exists, it asks before replacing that one folder. Replaced skills are backed up under ~/.codex/skills/.codex-skills-backup-*, and unrelated local skills are left alone.
Restart Codex or open a fresh session so the skill list reloads.
To install one skill instead, copy just that folder into ~/.codex/skills/, or set a custom target with CODEX_SKILLS_DIR=/path/to/skills sh scripts/install.sh.
For skills that should stay current on multiple machines, keep a canonical checkout at ~/.codex/sources/codex-skills and symlink selected skills into ~/.codex/skills:
git clone https://github.com/EyrieCommander/codex-skills.git "$HOME/.codex/sources/codex-skills"
mkdir -p "$HOME/.codex/skills"
ln -s "$HOME/.codex/sources/codex-skills/skills/codex-history-repair" "$HOME/.codex/skills/codex-history-repair"If the destination already exists, compare and preserve it before creating the symlink; do not overwrite an installed skill blindly. Thereafter, update the source checkout without reinstalling:
git -C "$HOME/.codex/sources/codex-skills" pull --ff-onlyThe symlink exposes the updated files immediately. Restart Codex or open a fresh session when the skill catalog needs to reload.
Some skills have external tool expectations. For example, pdf works best with Poppler and Python PDF libraries, and video-perception expects the Codex video-vision workflow to be available.
See CATALOG.md for per-skill status, NOTICE.md for upstream sources and license notes, and CONTRIBUTING.md for release and safety rules.
This repository is MIT licensed except where included skill folders carry their own upstream license files. See NOTICE.md and CATALOG.md for per-skill provenance.