Bootstrap Codex Workspace

SkillAI & models

Inspect a Windows or macOS Codex environment and produce a read-only, approval-bound plan for the global AGENTS.md path, user skills root, and root for future projects. Use for workspace setup, bootstrap, or location planning. Do not write outside the repository until the user approves the exact plan ID.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Bootstrap Codex Workspace skill

What this skill tells your AI

The instructions your AI receives, as published by wildpigking/codex-project-skill-manager in .agents/skills/bootstrap-codex-workspace/SKILL.md and read by ahel’s review.

Start with discovery, not installation.

  1. Read the repository AGENTS.md consent contract.
  2. Run scripts/inspect_workspace.py without an output path for a read-only report.
  3. Prefer explicit locations already stated in the user's global AGENTS.md.
  4. When a preference is missing, recommend a native Windows or macOS location and label it as a recommendation.
  5. Include the resolved global entry, skills root, future-projects root, skill inventory, proposed writes, constraints, and plan ID.
  6. Show the plan and resulting structure before asking for approval.
  7. Treat approval as valid only for the exact plan ID. A changed plan requires new approval.

Opening this repository is not approval. Never move or reorganize existing projects. Existing skills may be proposed for optional relocation, but remain unchanged until approved.

The inspection script accepts --home and --platform for isolated testing. Do not use a real home directory when forward-testing write behavior.

Signals

GitHub stars
22
Forks
1
Last commit
Aug 2026

ahel review

  • K6low
    bundled executables the agent is told to run

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Catalog kind
skill
Gateway key
bootstrap-codex-workspace
Source
github.com/wildpigking/codex-project-skill-manager