Skip to content
Skills Library
AI & agents · Tool integration

codex-setup

/codex-setup

Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.

Licence
MIT
Last repository change
25.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/install-codex-agents.mjs

What it does and when to use it

Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.

Original author description

Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.

How it works

  1. Workflow
  2. Installer Options
Original SKILL.md headings · 49 lines, 264 words
SKILL.md preview
---
name: codex-setup
description: Install or refresh PARA-ZK Codex custom agents from the plugin's bundled Claude-style agent definitions. Use when a Codex user wants PARA-ZK workflows such as wiki-ingest to spawn named agents like wiki-weaver, or after installing/upgrading the PARA-ZK plugin in Codex.
---

# Codex Setup

Install PARA-ZK custom agents into the user's Codex agent directory. This bridges
the plugin's shared `clients/agents/*.md` agent definitions into Codex's
`~/.codex/agents/*.toml` custom-agent format.

## Workflow

1. Run the bundled installer. Do not block installation on Optsidian or its MCP
   server: those are runtime command transports, not installer dependencies.

   ```bash
   node clients/skills/codex-setup/scripts/install-codex-agents.mjs
   ```

   When running from an installed plugin cache, resolve the path relative to this
   `SKILL.md` file:

   ```bash
   node <this-skill-dir>/scripts/install-codex-agents.mjs
   ```

2. Check and report which runtime command transport the installed agents can use,
   without failing or undoing the installation:
   - Prefer `mcp__optsidian__command_run` when it is available in the current
     session.
   - Otherwise use `optsidian` from `PATH`.
   - Otherwise fall back to the native `obsidian` CLI from `PATH`.
   - If none is available, warn that vault-working agents such as `wiki-weaver`
     cannot run yet. The agent files are still installed successfully.
3. Report the installed, updated, unchanged, and warning lines from the script.
4. Tell the user to restart Codex or start a new thread before expecting the new
   agent names to appear.

## Installer Options

- `--dry-run`: print what would be written without modifying files.
- `--force`: accepted for compatibility with older instructions; installs now
  overwrite existing agent TOML files by default.
- `--out-dir <path>`: write to a custom Codex agent directory instead of
  `${CODEX_HOME:-~/.codex}/agents`.
- `--source-dir <path>`: read agent markdown files from a custom directory instead
  of the plugin's `clients/agents`.

Default installs are destructive for managed agent names: an existing different
TOML file at the generated target path is overwritten with the bundled agent
definition. Use `--dry-run` to preview writes.
Files in this package (2)
  • SKILL.md 2 KB
  • scripts/install-codex-agents.mjs 7 KB

Versions

RepositoryScoreLicence
This page · kangig94/obsidian-para-zk100MIT
sd0xdev/sd0x-harness95MIT

Database snapshot: 13.11.2026 · package version dcd1052f4bb6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 81codex-agents-bootstrap
    Install or refresh custom agents shipped by solopreneur-family plugins in the Codex user agents directory. Use after installing, updating, enabling, or disabling a solopreneur-family plugin, or when the user asks to bootstrap, install, refresh, or diagnose Codex agents. This is…
  • 100wiki-ingest
    Use when ingesting canonical PARA-ZK sources into the LLM-Wiki — per-import, delta, uncited, or targeted re-ingest.
  • 86wiki-ingest
    把 agent 会话里的知识摄入 Meiqiu 知识库(个人 LLM Wiki)。当用户要求把会话摄入知识库、提炼知识到 wiki 时使用。
  • 100codex-to-cc
    One-shot conversion of a Codex plugin to Claude Code format. Use when asked to convert a Codex plugin to Claude Code, add CC support for a Codex plugin, or reverse-port a plugin from Codex.
  • 100custom-agent-definitions
    Write and configure custom agent definitions in Claude Code agents/ directory. Use when creating an agent .md file, defining a specialized agent, or configuring agent tools.
  • 100bootstrap
    Bootstrap an LLM-maintained wiki for the current project. Use when a user asks to create, initialize, or refresh a project wiki, LLM wiki, QMD wiki, or codebase knowledge base for Claude Code, Codex, or Pi.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.