Preface

If the local machine already has Codex CLI installed, there may be a batch of plugin caches and skills in ~/.codex. If the DSH side wishes to reuse these skills, manual copying will encounter issues such as inconsistent frontmatter fields, Codex-specific files mixed in plugin directories, and overwriting of skills with the same name.

dsh-codex-port is a DSH plugin designed to scan the local Codex plugin directory, batch-migrate available skills to DSH skills, and also support output to other directories that support the Agent Skills (SKILL.md) format.

What Is This

The repository address for dsh-codex-port is STARDUSTLC666/dsh-codex-port. It mainly does three things: listing local Codex plugins and skills, batch-migrating skills, and comparing migration status. The license is MIT.

Core Features

Below are the capabilities listed in an actionable manner.

  • Scans unpacked plugins and plugin caches in ~/.codex.
  • Batch-migrates skills from official Codex plugins to DSH skills.
  • Automatically converts frontmatter: name/description/metadata are converted to name/description/compatibility/allowed-tools, with multi-line descriptions fully preserved.
  • Excludes Codex-specific files, such as sub-agent descriptions like agents/*.yaml, which will not be carried into the target directory.
  • Name sanitization: illegal characters are replaced with underscores, and .. path traversal is directly rejected.
  • Idempotent processing: skills with the same name are skipped by default, and only overwritten when overwrite=true is set.
  • Security boundaries: based on verified information, it performs pure file system operations, with runtime dependencies only on yaml parsing; package.json declares node >=22.

Installation and Enabling

The local machine needs to have Codex CLI installed, and at least the ~/.codex directory must exist.

Add the plugin:

dsh plugin --profile web add dsh-codex-port

All configuration options are optional and usable with defaults. Configurable options include:

codexHome
targetDir
overwrite
  • codexHome: Codex home directory, default is ~/.codex.
  • targetDir: Target skill directory.
  • overwrite: Whether to overwrite skills with the same name; default is to skip.

Uninstall:

dsh plugin --profile web remove dsh-codex-port

After uninstalling, restart the web service. For thorough cleanup, you can also manually remove the plugin line covered in your profile’s cordis.patch.yml.

Tools and Typical Usage

The plugin provides three tools: codex_list, codex_port, and codex_status.

View

codex_list {}
codex_list { plugin: remotion }

codex_list is used to list discovered Codex plugins and skills, supporting plugin/skill filtering, with limit ranging from 1 to 200.

Migrate

codex_port {}
codex_port { plugins: [remotion, hyperframes] }
codex_port { skills: [video-best], overwrite: true }
codex_port { targetDir: ~/.claude/skills }

codex_port is used for batch migration to DSH skills, supporting plugins/skills filtering, targetDir, and overwrite. targetDir is not limited to DSH; it can also point to other directories that support the Agent Skills (SKILL.md) format, such as Claude Code, Cursor, and Gemini CLI.

Status

codex_status {}

codex_status is used to compare source and target, and quantify the migrated and unmigrated status.

Applicable Scenarios and Notes

Suitable for situations like:

  • The local machine already has Codex CLI installed, and there are scannable plugins or caches in ~/.codex.
  • You wish to bring Codex skills to the DSH skill directory or to other Agent Skills directories like Claude Code.
  • You wish to use codex_status to check which skills have not yet been migrated.

Notes:

  • The plugin accesses the local file system with the permissions of the currently running DSH process. It is recommended to review the source code and license (MIT) before installation.
  • This plugin has been verified on @deepseek-ai/dsh@0.1.1-rc.2 (2026-08-26).
  • Skills with the same name are not overwritten by default; to overwrite, explicitly pass overwrite=true.
  • If the target directory points to other agents, please confirm that they support the Agent Skills / SKILL.md format and verify the target directory permissions yourself.
https://github.com/STARDUSTLC666/dsh-codex-port