Files

T

AreChen bfe3275e21 Localize marketplace metadata and group Three.js skills

Constraint: Chinese users need localized plugin and skill descriptions while third-party sources must remain syncable from upstream.

Rejected: Editing third-party generated files by hand | Sync would overwrite them and make localization drift from config.

Rejected: One plugin per Three.js skill | Users should install one domain package while Codex can still select individual skills inside it.

Confidence: high

Scope-risk: moderate

Directive: Keep plugin IDs and skill names in English kebab-case; put user-facing Chinese text in manifest fields, SKILL.md descriptions, or external-source overrides.

Tested: Codex manual confirms duplicate skills are not merged; powershell sync_external_plugins.ps1 with proxy; python scripts\\validate_marketplace.py; validate_plugin.py for all plugins; codex plugin list local marketplace; codex plugin add/remove eapil-threejs.

Not-tested: Codex Desktop visual refresh after pulling the updated remote marketplace.

2026-06-10 16:12:27 +08:00

3.1 KiB

Raw Blame History

EAPIL Skill Market

Codex custom plugin marketplace test repository.

Desktop test

In Add plugin marketplace:

Source: https://git.playones.com/arechen/EapilSkillMarket.git
Git ref: main
Sparse path: leave empty

After the marketplace is added, install only the plugin you need from the EAPIL Skill Market marketplace.

If you want to use sparse checkout, enter both paths if the UI allows multiple lines:

.agents
plugins/codex

CLI test

codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main
codex plugin add eapil-pdf@eapil-skill-market

Sparse CLI form:

codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main --sparse .agents --sparse plugins/codex
codex plugin add eapil-xlsx@eapil-skill-market

For local testing before pushing:

codex plugin marketplace add .
codex plugin add eapil-pptx@eapil-skill-market

Start a new Codex thread after installing so the new skills are loaded into context.

Plugins

eapil-pdf
eapil-pptx
eapil-xlsx
eapil-threejs
superpowers
ui-ux-pro-max

List available plugins:

codex plugin list --marketplace eapil-skill-market --available

Remove an installed plugin:

codex plugin remove eapil-pdf@eapil-skill-market

External sync

Third-party plugins are configured in config/external-sources.json and synced with:

powershell -ExecutionPolicy Bypass -File .\scripts\sync_external_plugins.ps1

If GitHub access is unstable locally, use the proxy:

powershell -ExecutionPolicy Bypass -File .\scripts\sync_external_plugins.ps1 -Proxy http://127.0.0.1:18085

The sync script currently supports:

codex-plugin: mirrors an upstream Codex plugin repo, used for obra/superpowers.
claude-skill: converts one Claude-style skill directory into a Codex plugin, used for nextlevelbuilder/ui-ux-pro-max-skill.

Use manifestOverrides and skillDescriptions in config/external-sources.json for local Chinese UI text and skill descriptions. These overlays are applied after each upstream sync, so do not edit generated third-party plugin files directly for localization.

After sync, validate the marketplace:

python scripts\validate_marketplace.py

Periodic sync should call the script directly from a maintenance process, cron job, or service container. Keep the scheduling layer outside this repository; the repository only defines source config, generated plugin output, and validation.

Layout

.agents/plugins/marketplace.json
plugins/codex/
  .agents/plugins/marketplace.json
  plugins/eapil-pdf/
    .codex-plugin/plugin.json
    skills/pdf/
  plugins/eapil-xlsx/
    .codex-plugin/plugin.json
    skills/xlsx/
  plugins/eapil-threejs/
    .codex-plugin/plugin.json
    skills/threejs-fundamentals/
    skills/threejs-materials/
    skills/threejs-shaders/
  plugins/superpowers/
    .codex-plugin/plugin.json
    skills/
  plugins/ui-ux-pro-max/
    .codex-plugin/plugin.json
    skills/ui-ux-pro-max/

3.1 KiB Raw Blame History