⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

codex-agent-collaboration

fortescarlet@fortescarlet⭐ 27 stars· last commit 9mo ago· 0 open issues

Delegate coding tasks to Codex AI for implementation, analysis, and alternative solutions. Use when you need a second AI perspective, want to explore different approaches, or need specialized Codex capabilities for complex coding tasks.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐ 27 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Codex KKP

KKP: Kotlin Claude Code sKill Plugin.

Overview

中文 | English

Codex KKP is a Claude Code Plugin that enables seamless integration with Codex AI Agent for code analysis, implementation, and collaboration tasks. Provides a subagent and a skill for Codex AI Agent.

Features

  • Multi-platform Support: Native binaries for macOS, Linux, and Windows
  • Streamlined results: By default, only completed results are returned to reduce token consumption.
  • Sandbox Modes: Configurable security levels (read-only, workspace-write, danger-full-access)
  • Session Management: Resume previous sessions and maintain context
  • Claude Code Subagents: Run subagents in parallel to improve performance
  • Sugar-Free, Calorie-Free: Very healthy

Usage

After installation and configuration, you can use the Codex KKP plugin within Claude Code. The plugin provides a subagent and a skill for code analysis, implementation, and collaboration tasks.

You can verify successful installation by using /agents or by asking "What skills do you have?". Once successfully installed, you can prompt Claude Code to use Codex subagents or skills through prompts, for example:

Actively collaborate deeply with codex and subagents for task coordination and code review, ensure code quality, and perform tasks concurrently
Use Codex to review code changes

Claude Code will decide on its own whether to use Skills or agents based on the prompts.

File Operations

codex-kkp requires codex to use sandbox=read-only mode by default. If you need codex to directly modify files, Claude Code must specify the correct sandbox=workspace-write mode or add the --full-auto parameter (more dangerous) when calling codex-kkp.

This is mentioned in the skills progressive documentation, but if Claude Code still cannot understand it on its own, you can include these details in your prompts.

Codex will return file operation content, provided it uses tool APIs like apply_patch rather than some Bash/Command operations.

Installation

Download from repository

1. Download/Clone source from repository

1.1 Download source

Download the source code for Branch plugins/release and extract it.

1.2 Clone source

OR clone the repository and check out Branch plugins/release .

git clone -b plugins/release https://github.com/ForteScarlet/codex-kkp.git

2. Add into Claude Code's marketplace

Run claude:

claude

Use /plugin:

/plugin

Choose Add marketplace:

> Add marketplace

and enter the local path where you downloaded/cloned the repository.

Download from releases

Go to the releases and select a version (such as the latest version).

Select the content you need from assets, download it, and configure it:

1. Download marketplace zip file

The compressed file codex-agent-collaboration-marketplace.zip in Assets is a complete marketplace package that includes plugins and skills.

After downloading and extracting, run Claude Code:

claude

Use the /plugin command:

/plugin

Choose Add marketplace:

> Add marketplace

Then enter the local path of your extracted marketplace directory (the directory containing the .claude-plugin directory).

2. Download skills zip file

The compressed file codex-agent-collaboration.zip in Assets contains a unified multi-platform skill bundle. You can download and unzip it, then place the extracted directory in your skills directory (e.g., <PROJECT_DIR>/.claude/skills/codex-agent-collaboration/).

This single ZIP file includes executables for all supported platforms:

  • macOS x86_64 (Intel) - executables/codex-kkp-cli-macosx64
  • macOS ARM64 (Apple Silicon) - executables/codex-kkp-cli-macosarm64
  • Linux x86_64 - executables/codex-kkp-cli-linuxx64
  • Linux ARM64 - executables/codex-kkp-cli-linuxarm64
  • Windows x86_64 - executables/codex-kkp-cli-mingwx64

Claude Code will automatically select the appropriate executable for your system.

3. Download executable binary file

Standalone binary files (e.g., codex-kkp-cli-macosx64, codex-kkp-cli-mingwx64) in Assets are raw executable binaries for each platform. You can download only the executable file for your platform and design the skills yourself.

Note: All executables use uniform naming without file extensions (including Windows (mingwx64) builds).

Configuration

Once you've finished installing the plugin, you can proceed to configure some of your settings in advance.

Edit the .claude/settings.local.json file in your project and add the following configuration to property permissions.allow:

Install skill only

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

Install full plugin via marketplace

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/marketplace/codex-kkp-skills-marketplace/codex-agent-collaboration-plugin/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

If loading locally, then ~/.claude/marketplace/ should be replaced with the directory of your locally downloaded codex-kkp-skills-marketplace.

In Bash, the path refers to the executable file within the installed plugin package that corresponds to your system platform. You may need to make slight adjustments based on the actual situation.

Uninstall

Sometimes, when you try to update or uninstall a marketplace, due to issues with the Claude Code CLI itself, the plugin may not be completely uninstalled. This can lead to problems such as being unable to completely clear the plugin's activation, or being unable to enable/re-enable plugins when reloading/reinstalling the marketplace. If you encounter this issue, you can go to the plugins subdirectory in Claude Code's configuration directory, for example:

~/.claude/plugins

Manually clean up the configuration files like installed_plugins.json and known_marketplaces.json to remove the marketplaces and plugins you have already uninstalled, then restart a new CLI.

For this reason, it is recommended to uninstall any plugins before removing marketplace.

License

This project is licensed under the MIT License - see the LICENSE file for details.

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • claude-code-skills-template/codex-agent-collaboration/SKILL.md3.6 KBupstream ↗
    ---
    name: codex-agent-collaboration
    description: Delegate coding tasks to Codex AI for implementation, analysis, and alternative solutions. Use when you need a second AI perspective, want to explore different approaches, or need specialized Codex capabilities for complex coding tasks.
    ---
    
    # Codex CLI Skill
    
    This skill enables Claude Code to execute tasks using OpenAI's Codex AI agent.
    
    ## Overview
    
    The `codex-kkp-cli` is a Codex Agent CLI tool, allowing you to:
    
    - Execute coding tasks and get implementations
    - Perform code analysis and reviews
    - Get alternative solutions and suggestions
    - Collaborate with Codex for cross-checking implementations
    
    ## Usage
    
    ### Basic Syntax
    
    ```bash
    # Direct call with platform-specific executable
    executables/codex-kkp-cli-{platform} --cd=/absolute/path/to/project [options] "<task_description>"
    ```
    
    Where `{platform}` is one of:
    - `macosx64` - macOS Intel (x86_64)
    - `macosarm64` - macOS Apple Silicon (ARM64)
    - `linuxx64` - Linux x86_64
    - `linuxarm64` - Linux ARM64
    - `mingwx64` - Windows x86_64
    
    **Platform Auto-Detection Helper**: A platform detection script is provided to help identify your current platform:
    
    > On Windows, Just use mingwx64 platform directly, no need to use script detection.
    
    ```bash
    # Unix/Linux/macOS
    codex-kkp-cli-platform
    # Outputs: macosx64, macosarm64, linuxx64, or linuxarm64
    ```
    
    ### communication
    
    This is AI-to-AI communication between You and Codex. PRIORITIZE ACCURACY AND PRECISION over human readability.
    Use structured data, exact technical terms, full paths, and precise details. NO conversational formatting needed.
    
    ### Required Parameters
    
    | Parameter    | Description                                                |
    |--------------|------------------------------------------------------------|
    | Task         | The task description (positional argument, must be quoted) |
    | `--cd=<dir>` | Working directory (ABSOLUTE PATH REQUIRED)                 |
    
    ### Optional Parameters
    
    | Parameter                      | Description                                                                    |
    |--------------------------------|--------------------------------------------------------------------------------|
    | `--session=<id>`               | Session ID (STRONGLY RECOMMENDED for follow-up chats to maintain context)      |
    | `--sandbox=<mode>`             | Sandbox mode. Default is `read-only`. See [sandbox-modes.md](sandbox-modes.md) |
    | `--full-auto`                  | Allow Codex to edit files automatically                                        |
    | `--image=<path>`               | Include an image file (ABSOLUTE PATH, can repeat)                              |
    | `--skip-git-repo-check[=BOOL]` | Skip Git repository check. Default is `true`. Use `=false` to enable Git check |
    
    For output options (`--full`, `--output-last-message`, `--output-schema`), see [outputs.md](outputs.md).
    
    NOTE that parameters and values are connected by an EQUAL SIGN `=`, not a space.
    
    ## Response Format
    
    Returns JSON with `"type": "SUCCESS"` or `"type": "ERROR"`.
    
    ```JSON
    {
      "type": "SUCCESS",
      "session": "xxxxxxx",
      "content": {
        "agentMessages": "I've analyzed the code and found...",
        "fileChanges": [...],   // Optional
        "nonFatalErrors": [...] // Optional
      }
    }
    ```
    
    - `fileChanges` and `nonFatalErrors` is nullable.
    - Error responses do NOT include a `session` field.
    
    ## Quick Example
    
    New Session:
    
    ```bash
    executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"
    ```
    
    Continue Previous Session:
    
    ```bash
    executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"
    ```
    
    More examples: [examples.md](examples.md)
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/fortescarlet-codex-kkp-claude-code-skills-template-codex-agent-collaboration.md

// REPO STATS

27 stars
0 open issues
Last commit: 9mo ago