Agent skill

Codex Document Mode macOS

by 4thfever in 4thfever/codex-document-mode

Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS.

MITAuto-check passed

Install Codex Document Mode macOS

skills CLI
$ npx skills add 4thfever/codex-document-mode --skill codex-document-mode-macos -a claude-code

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

GitHub CLI
$ gh skill install 4thfever/codex-document-mode codex-document-mode-macos --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/4thfever/codex-document-mode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/macos .claude/skills/codex-document-mode-macos && 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
codex-document-mode-macos
GitHub stars
127
Token cost
~661 tokens
SKILL.md length
299 words
Files
66 (incl. scripts, references, assets)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS.

  • Works in 4 steps: Run Install Codex Dream Skin.command… → Run Start Codex Dream Skin.command to… → Verify the live result with Verify Codex… → …
  • A user wants formal document presentation
  • SKILL.md covers Workflow, Guardrails and Key resources
  • Circle/cross feedback in official Codex Desktop without modifying the official app

What it does

Codex Document Mode macOS is an agent skill from 4thfever/codex-document-mode. Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS. Use when a user wants formal document presentation, prose guidance, or circle/cross feedback in official Codex Desktop without modifying the official app.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 67 other files, including scripts, reference files and assets (for example `CHANGELOG.md`, `CLIENT_DEPLOY_PROMPT.md` and `NOTICE.md`). Compatibility notes: macOS, official Codex Desktop app, signed bundled Node.js 20 or newer

It works with macOS. The licence is MIT.

When your agent uses it

  • A user wants formal document presentation
  • Circle/cross feedback in official Codex Desktop without modifying the official app

Example prompts

  • “/codex-document-mode-macos”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): macOS, official Codex Desktop app, signed bundled Node.js 20 or newer

Workflow steps

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

  1. Run Install Codex Dream Skin.command from the complete project folder.
  2. Run Start Codex Dream Skin.command to launch or reapply the bundled preset-codex-document.
  3. Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal…
  4. Restore the official appearance with Restore Codex Dream Skin.command.

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    macOS, official Codex Desktop app, signed bundled Node.js 20 or newer

    From compatibility in the SKILL.md frontmatter.

Context cost

Codex Document Mode macOS loads about 661 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 66 tokens; SKILL.md has 299 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder are not scanned.

SKILL.md

The full file from 4thfever/codex-document-mode at commit b92427d, republished under its MIT licence (© 4thfever). 299 words, ~661 tokens.

Download SKILL.mdSave it as .claude/skills/codex-document-mode-macos/SKILL.md (or your agent's skills folder). This skill also uses 65 other files; get the full folder from GitHub.
name
codex-document-mode-macos
description
Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS. Use when a user wants formal document presentation, prose guidance, or circle/cross feedback in official Codex Desktop without modifying the official app.
compatibility
macOS, official Codex Desktop app, signed bundled Node.js 20 or newer

Codex Dream Skin Studio

This file is an optional Codex capability entry. The delivery is a complete standalone project; users do not need to install it as a Skill.

Workflow

  1. Run Install Codex Dream Skin.command from the complete project folder.
  2. Run Start Codex Dream Skin.command to launch or reapply the bundled preset-codex-document.
  3. Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal overflow, and a document shell for assistant messages.
  4. Restore the official appearance with Restore Codex Dream Skin.command.

Guardrails

  • Never modify the official .app, app.asar, or its code signature.
  • Use the official Codex app's signed Node.js runtime only after validating its signature, Team ID, architecture, and minimum version.
  • Bind CDP to loopback, verify that the listener belongs to Codex, and reject non-Codex renderer targets.
  • Preserve all native cards, navigation, project selectors, task content, composer controls, and keyboard focus.
  • Document mode never paints a full-window wallpaper. Scope its CSS to assistant document shells and the local composer feedback board.
  • The prose wrapper is temporary and limited to one real native send action; it must restore the visible original draft on send, pause, remove, reload, reapply, restore, and exit.
  • The feedback board recognizes only high-confidence red circles and crosses, appends editable feedback text, and may click only the native send button under the documented empty-draft conditions.
  • Keep decoration at pointer-events: none.
  • Require explicit authorization before restarting an already-running Codex instance.
  • Stop an injector only when its recorded PID, executable, command line, and start time all match.

Key resources

  • README.md: user installation and customization guide.
  • scripts/injector.mjs: CDP connection, injection, removal, verification, and screenshots.
  • assets/dream-skin.css: live native interface styling.
  • assets/renderer-inject.js: idempotent DOM integration and cleanup.
  • scripts/doctor-macos.sh: signed-runtime, payload, and optional live-session self-check.
  • references/qa-inventory.md: release and visual acceptance criteria.

© 4thfever, 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 65 other files (scripts, references, assets) in macos of 4thfever/codex-document-mode.

  • SKILL.md
  • .gitignore
  • CHANGELOG.md
  • CLIENT_DEPLOY_PROMPT.md
  • Customize Codex Dream Skin.command
  • Install Codex Dream Skin.command
  • Install Menu Bar.command
  • LICENSE
  • NOTICE.md
  • README.md
  • Restore Codex Dream Skin.command
  • Start Codex Dream Skin.command
  • VERSION
  • Verify Codex Dream Skin.command
  • agents/openai.yaml
  • assets/dream-reference.jpg
  • assets/dream-skin.css
  • assets/portal-hero.png
  • assets/prose-style-guide.md
  • … and 47 more

Open the folder on GitHubat commit b92427d

Compare with similar skills

Codex Document Mode macOS 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.

Codex Document Mode macOS compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Document Mode macOS this skill4thfever/codex-document-mode127—~661Automated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80411 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca88k1 repos~584Automated safety check: PassApache-2.0

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    804 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    88k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from 4thfever/codex-document-mode

  • Codex Dream Skin

    4thfever/codex-document-mode

    Apply, launch, verify, repair, update, or restore a full decorative skin for the Windows Codex desktop app.

    127 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed
  • Codex Official Prose Style

    4thfever/codex-document-mode

    Apply the project's formal Chinese prose rules, functional official-style phrases, and context-aware endings when drafting or revising user-requested formal responses.

    127 GitHub stars~737 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Codex Document Mode macOS

What does Codex Document Mode macOS do?

Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS. Codex Document Mode macOS is an agent skill from 4thfever/codex-document-mode. Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS.

When should I use Codex Document Mode macOS?

Codex Document Mode macOS fits situations like: A user wants formal document presentation; circle/cross feedback in official Codex Desktop without modifying the official app.

How do I install Codex Document Mode macOS in Claude Code?

Run `npx skills add 4thfever/codex-document-mode --skill codex-document-mode-macos -a claude-code`. Or copy the skill folder (macos in 4thfever/codex-document-mode) into .claude/skills/codex-document-mode-macos in your project. Claude Code loads it when a task matches its description.

How do I install Codex Document Mode macOS in Codex?

Run `npx skills add 4thfever/codex-document-mode --skill codex-document-mode-macos -a codex`. Or copy the skill folder (macos in 4thfever/codex-document-mode) into .agents/skills/codex-document-mode-macos in your project. Codex loads it when a task matches its description.

Can I use Codex Document Mode macOS 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 4thfever/codex-document-mode --skill codex-document-mode-macos -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-document-mode-macos, .gemini/skills/codex-document-mode-macos, .github/skills/codex-document-mode-macos and .opencode/skills/codex-document-mode-macos in your project.

What does Codex Document Mode macOS need to run?

SKILL.md names no scripts, command-line tools or credentials: Codex Document Mode macOS is instructions for the agent only. Our summary lists: Node.js. Compatibility (from SKILL.md): macOS, official Codex Desktop app, signed bundled Node.js 20 or newer.

Does Codex Document Mode macOS access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex Document Mode macOS safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codex Document Mode macOS use?

Codex Document Mode macOS is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex Document Mode macOS use?

About 661 tokens (SKILL.md is roughly 2.6k 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 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Codex Document Mode macOS?

Skills that share tags, products or a category with Codex Document Mode macOS: Site Architecture (AvdLee/RocketSimApp, 804 stars), Engine Whats New (flutter/flutter, 179k stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Document Mode macOS?

4thfever (a GitHub user) maintains it in 4thfever/codex-document-mode, which has 127 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on July 30, 2026.

Source: 4thfever/codex-document-mode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.