test release: v0.0.3

Author: ForteScarlet

README.md

@@ -21,10 +21,20 @@ analysis, implementation, and collaboration tasks.
 
 **1. Download/Clone source from repository**
 
+**1.1 Download source**
+
 [Download](https://github.com/ForteScarlet/codex-kkp/archive/refs/heads/skills/release.zip) 
-the source code for Branch `skills/release` and extract it, or clone the repository and 
+the source code for Branch `skills/release` and extract it, 
+
+**1.2 Clone source**
+
+**OR** clone the repository and 
 [check out Branch `skills/release`](https://github.com/ForteScarlet/codex-kkp/tree/skills/release) .
 
+```
+git clone -b skills/release https://github.com/ForteScarlet/codex-kkp.git
+```
+
 **2. Add into Claude Code's marketplace**
 
 Run claude:
@@ -42,5 +52,36 @@ Choose `Add aarketplace` and enter the local path where you downloaded/cloned th
 
 ### Download from releases
 
-TODO
+Go to the [releases](https://github.com/ForteScarlet/codex-kkp/releases)
+page and select a version (such as the [latest](https://github.com/ForteScarlet/codex-kkp/releases/latest) version).
+
+Select the content you need from assets, download it, and configure it.
+
+#### 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 Intel (x86_64) - `executables/codex-kkp-cli-macosx64`
+- macOS Apple Silicon (ARM64) - `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.
+
+#### 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 builds).
+
+### Tool installation and management
 
+Some open-source projects may allow independent management of marketplaces 
+and skills through repository addresses and branches (e.g., [cc-switch](https://github.com/farion1231/cc-switch)). 
+You can also configure skills directly based on repositories and branches using these tools.

claude-code-skills-template/codex-agent-collaboration/SKILL.md

@@ -18,10 +18,19 @@ The `codex-kkp-cli` is a Codex Agent CLI tool, allowing you to:
 
 ## Usage
 
+### Basic Syntax
+
 ```bash
-executable/codex-kkp-cli --cd=/absolute/path/to/project [options] "<task_description>"
+executables/codex-kkp-cli-{platform} --cd=/absolute/path/to/project [options] "<task_description>"
 ```
 
+**Platform Variable**: `{platform}` should be automatically replaced based on current system:
+- `macosx64` - macOS Intel (x86_64)
+- `macosarm64` - macOS Apple Silicon (ARM64)
+- `linuxx64` - Linux x86_64
+- `linuxarm64` - Linux ARM64
+- `mingwx64` - Windows x86_64
+
 ### Required Parameters
 
 | Parameter    | Description                                                |
@@ -71,13 +80,13 @@ Returns JSON with `"type": "SUCCESS"` or `"type": "ERROR"`.
 New Session:
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project "Explain the main function in Main.kt"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"
 ```
 
 Continue Previous Session:
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"
 ```
 
 More examples: [examples.md](examples.md)

claude-code-skills-template/codex-agent-collaboration/examples.md

@@ -7,51 +7,51 @@ This document provides examples of using the Codex CLI for various tasks.
 ### Simple Task
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project "Explain the main function in Main.kt"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"
 ```
 
 ### Continue Previous Session
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --session=previous-session-id "Now implement the suggested changes"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=previous-session-id "Now implement the suggested changes"
 ```
 
 ### Code Review with Full Auto
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --full-auto --sandbox=workspace-write "Review this implementation for bugs and suggest improvements"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --full-auto --sandbox=workspace-write "Review this implementation for bugs and suggest improvements"
 ```
 
 ## Advanced Examples
 
 ### With Image Input
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --image=/path/to/screenshot.png "Implement the UI shown in this design"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --image=/path/to/screenshot.png "Implement the UI shown in this design"
 ```
 
 ### Multiple Images
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --image=/path/to/design1.png --image=/path/to/design2.png "Compare these two designs and implement the better approach"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --image=/path/to/design1.png --image=/path/to/design2.png "Compare these two designs and implement the better approach"
 ```
 
 ### Full Event Output
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --full "Refactor the authentication module"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --full "Refactor the authentication module"
 ```
 
 ### Save Last Message to File
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --output-last-message=/tmp/codex-response.txt "Generate API documentation"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --output-last-message=/tmp/codex-response.txt "Generate API documentation"
 ```
 
 ### Structured Output with Schema
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --output-schema=/path/to/schema.json "Extract all function signatures from this module"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --output-schema=/path/to/schema.json "Extract all function signatures from this module"
 ```
 
 ### With Git Repository Check
@@ -60,5 +60,5 @@ By default, Git repository check is skipped (`--skip-git-repo-check=true`).
 To enable Git check (e.g., for ensuring clean working directory):
 
 ```bash
-executable/codex-kkp-cli --cd=/path/to/project --skip-git-repo-check=false "Analyze uncommitted changes"
+executables/codex-kkp-cli-{platform} --cd=/path/to/project --skip-git-repo-check=false "Analyze uncommitted changes"
 ```

claude-code-skills-template/codex-agent-collaboration/outputs.md

@@ -64,7 +64,7 @@ This produces significantly larger output and should only be used when you need
 Save the last agent message to a specified file:
 
 ```bash
-executable/codex-kkp-cli \
+executables/codex-kkp-cli-{platform} \
   --cd="/path/to/project" \
   --output-last-message="/path/to/output/response.txt" \
   "Analyze this code"
@@ -75,7 +75,7 @@ executable/codex-kkp-cli \
 Specify a JSON schema file for structured output:
 
 ```bash
-executable/codex-kkp-cli \
+executables/codex-kkp-cli-{platform} \
   --cd="/path/to/project" \
   --output-schema="/path/to/schema.json" \
   "Extract function signatures"

claude-code-skills-template/codex-agent-collaboration/sandbox-modes.md

@@ -14,7 +14,7 @@ Choose the appropriate mode based on your task requirements.
 Codex can only read files in the workspace. No modifications are allowed.
 
 ```bash
-executable/codex-kkp-cli \
+executables/codex-kkp-cli-{platform} \
   --cd="/path/to/project" \
   --sandbox=read-only \
   "Analyze this codebase"
@@ -31,7 +31,7 @@ executable/codex-kkp-cli \
 Codex can read and write files within the workspace directory.
 
 ```bash
-executable/codex-kkp-cli \
+executables/codex-kkp-cli-{platform} \
   --cd="/path/to/project" \
   --sandbox=workspace-write \
   --full-auto \
@@ -49,7 +49,7 @@ executable/codex-kkp-cli \
 Full system access including network operations. **Use with caution.**
 
 ```bash
-executable/codex-kkp-cli \
+executables/codex-kkp-cli-{platform} \
   --cd="/path/to/project" \
   --sandbox=danger-full-access \
   "Install dependencies and run tests"
@@ -63,11 +63,11 @@ executable/codex-kkp-cli \
 
 ## Security Considerations
 
-| Mode | File Read | File Write | Network | System Commands |
-|------|-----------|------------|---------|-----------------|
-| `read-only` | Workspace only | No | No | No |
-| `workspace-write` | Workspace only | Workspace only | No | No |
-| `danger-full-access` | Full | Full | Yes | Yes |
+| Mode                 | File Read      | File Write     | Network | System Commands |
+|----------------------|----------------|----------------|---------|-----------------|
+| `read-only`          | Workspace only | No             | No      | No              |
+| `workspace-write`    | Workspace only | Workspace only | No      | No              |
+| `danger-full-access` | Full           | Full           | Yes     | Yes             |
 
 ## Recommendations