# 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:

```text
.agents
plugins/codex
```

## CLI test

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

Sparse CLI form:

```powershell
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:

```powershell
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-animation`
- `eapil-threejs-fundamentals`
- `eapil-threejs-geometry`
- `eapil-threejs-interaction`
- `eapil-threejs-lighting`
- `eapil-threejs-loaders`
- `eapil-threejs-materials`
- `eapil-threejs-postprocessing`
- `eapil-threejs-shaders`
- `eapil-threejs-textures`
- `superpowers`
- `ui-ux-pro-max`

List available plugins:

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

Remove an installed plugin:

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

## External sync

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

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

If GitHub access is unstable locally, use the proxy:

```powershell
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`.

After sync, validate the marketplace:

```powershell
python scripts\validate_marketplace.py
```

`.gitea/workflows/sync-external-skills.yml` is a scheduled workflow prototype for Git-side periodic sync.

For a Docker-hosted Gitea instance, the workflow file alone is not enough. Gitea must have Actions enabled and an `act_runner` container registered before scheduled jobs will run. The runner that handles this repository should provide:

- A label matching `runs-on: ubuntu-latest`, or adjust the workflow to your runner label.
- `git`, `python`, and `pwsh` in the job environment.
- Network access from the job container to GitHub for upstream skill repos and to the Gitea instance for checkout/push.

If the Gitea server does not have Actions enabled, run the same sync command from a host cron job or a small maintenance container that checks out this repository, runs the sync script, validates, commits, and pushes changes.

## Layout

```text
.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-fundamentals/
    .codex-plugin/plugin.json
    skills/threejs-fundamentals/
  plugins/superpowers/
    .codex-plugin/plugin.json
    skills/
  plugins/ui-ux-pro-max/
    .codex-plugin/plugin.json
    skills/ui-ux-pro-max/
```