Agent Skills: Wox Plugin Submit2store

Submit a Wox plugin to the official store by ensuring the user has a reusable fork of Wox-launcher/Wox, checking whether the plugin ID already exists in store-plugin.json, adding a new store entry when missing, and preparing a pull request to Wox-launcher/Wox. Single-file SDK plugins should be hosted on a public GitHub gist. Use when the user wants to publish a Wox plugin to the store, verify whether it has already been listed, or have Codex run the store submission PR workflow.

ID: wox-launcher/wox/wox-plugin-submit2store

Repository

Wox-launcherLicense: GPL-3.0
27,5172,437

Install this agent skill to your local

npx skills add wox-launcher/wox --skill wox-plugin-submit2store

Skill Files

The files that make up wox-plugin-submit2store.

Download Skill

Loading file tree…

.agents/skills/wox-plugin-submit2store/SKILL.md

Skill Metadata

Name
wox-plugin-submit2store
Description
Submit a Wox plugin to the official store by ensuring the user has a reusable fork of Wox-launcher/Wox, checking whether the plugin ID already exists in store-plugin.json, adding a new store entry when missing, and preparing a pull request to Wox-launcher/Wox. Single-file SDK plugins should be hosted on a public GitHub gist. Do not open the store pull request unless ScreenshotUrls contains at least one public screenshot of the plugin running in Wox. Use when the user wants to publish a Wox plugin to the store, verify whether it has already been listed, or have Codex run the store submission PR workflow.

Wox Plugin Submit2store

Overview

Submit a plugin to the Wox store through a PR against Wox-launcher/Wox. Ensure a reusable fork exists first, read local plugin metadata, refuse duplicate submissions, and only modify store-plugin.json when the plugin ID is not already present. A store entry requires at least one public screenshot. Do not submit with an empty or omitted ScreenshotUrls, and do not open a PR that says a screenshot will be added later.

For single-file SDK plugins, host the plugin on a public GitHub gist. That is the simplest store delivery. Do not require a GitHub repository, plugin.json, or a .wox package. Example: https://gist.github.com/qianlifeng/04a9609de66eaa582a473f5852450ede

Workflow

  1. Ensure the user already has a fork of Wox-launcher/Wox, or create one.
  2. Read the current plugin (packaged repo, or the single-file .js/.py header) before touching the store repo.
  3. Validate that the plugin has enough public metadata and release assets for a store entry, including at least one public screenshot of the plugin running in Wox.
  4. Clone the user's fork into a temporary directory and add upstream for https://github.com/Wox-launcher/Wox.
  5. Check upstream store-plugin.json for the current plugin ID.
  6. Stop and tell the user not to submit when the ID already exists.
  7. Add the new store entry when the ID is absent.
  8. Commit on a branch in the fork and open a PR to Wox-launcher/Wox.

Ensure A Fork Exists First

Treat fork setup as the first gate. Do not clone or edit a working copy until one of these is true:

  • the user already has a fork of Wox-launcher/Wox
  • the current authenticated GitHub user can create one now

Use this order:

  1. Check whether the user already has a fork and reuse it when present.
  2. If gh is available and authenticated, create the fork from the CLI.
  3. If gh is unavailable, unauthenticated, or fails, send the user to the web fork flow and continue only after the fork exists.

For CLI-driven fork handling:

  • prefer reusing an existing fork instead of creating a new one
  • if a fork is missing, create it with GitHub CLI
  • after the fork exists, treat the fork as origin and the official repo as upstream

For web fallback:

  • direct the user to https://github.com/Wox-launcher/Wox/fork
  • wait for the user to confirm the fork is ready
  • continue by cloning the fork repository, not the upstream repository

When the user has direct write access to Wox-launcher/Wox, a fork is not required. Otherwise, do not assume direct push access.

Read Local Metadata First

For a single-file SDK plugin, read the JSON metadata header in the live .js or .py file (usually ~/.wox/wox-user/plugins/single-file/Wox.Plugin.<Name>.js). Prefer a public gist as Website / DownloadUrl. Upload the screenshot and icon to GitHub and use https://gist.github.com/user-attachments/assets/<id> URLs for IconUrl and ScreenshotUrls.

For a packaged SDK plugin, read at least:

  • plugin.json
  • package.json when version information needs confirmation
  • local screenshots or icon files when URLs need to be derived
  • git remotes to determine the GitHub repository URL

Extract or derive these values:

  • plugin Id
  • Name
  • Author
  • Version
  • MinWoxVersion
  • Runtime
  • Description
  • Website (gist HTML URL, or GitHub repository URL)
  • DownloadUrl (gist raw .js/.py URL, or .wox release asset)
  • public icon URL
  • required screenshot URLs: at least one public image of the plugin running in Wox
  • supported operating systems

Stop and ask the user to fix the source first when any of these conditions hold:

  • metadata still contains template placeholders such as {{.Id}} or {{.Name}}
  • a single-file plugin has no public gist whose raw URL path ends with .js or .py
  • a packaged plugin has no public repository URL or no installable .wox release asset
  • there is no screenshot, ScreenshotUrls would be empty or omitted, or the only screenshot is local and has no stable public URL
  • the icon is only local and no stable public URL can be formed

Clone The Fork And Check For Duplicates

Clone the user's fork into a temporary directory instead of modifying the current plugin workspace. Add the official repository as upstream so the branch and PR target remain Wox-launcher/Wox.

Inspect store-plugin.json from the current upstream default branch and search by the exact plugin ID from the local metadata.

When the ID already exists:

  • do not modify store-plugin.json
  • tell the user that the plugin is already listed
  • include the existing matching entry or its location so the user can verify it quickly

When the ID does not exist:

  • continue to create a new entry
  • preserve the file's existing formatting and ordering style

Build The Store Entry

Use the field template and sourcing rules in references/store-plugin-entry.md.

Apply these rules while building the JSON object:

  • Keep Id, Name, Author, Version, MinWoxVersion, and Runtime aligned with local plugin metadata.
  • Prefer a plain Description string when no i18n payload exists.
  • Add I18n only when the repository already has trustworthy localized copy.
  • Convert local OS names to the store style: Windows, Darwin, Linux (Macos in plugin headers becomes Darwin).
  • Set DateCreated and DateUpdated to the current local timestamp in YYYY-MM-DD HH:MM:SS.
  • For a gist-hosted single-file plugin: Website is the gist HTML URL, DownloadUrl is the gist raw URL including the .js or .py filename, and IconUrl / ScreenshotUrls are https://gist.github.com/user-attachments/assets/<id> links. Runtime is lowercase nodejs or python.
  • For a packaged plugin: use the canonical repository URL for Website, the latest .wox release asset for DownloadUrl, and public raw image URLs for IconUrl / ScreenshotUrls.
  • ScreenshotUrls must contain at least one public URL. Do not omit the field, submit [], or continue while telling the user that no screenshot is included yet. Ask for a screenshot and stop until one is uploaded. Use a cropped Wox launcher screenshot that shows the query and the plugin's real results, like https://raw.githubusercontent.com/Wox-launcher/Wox.Plugin.ColorPicker/main/images/screenshot1.png. Do not submit an icon, a README image, source code, or a full-desktop capture.

Before editing store-plugin.json, re-check that the generated URLs and filenames match the gist file name or the packaged repository layout.

Prepare The PR

After editing the cloned fork workspace:

  1. Create a branch such as codex/add-<plugin-name>-store-entry.
  2. Commit only the store-plugin.json change.
  3. Push to the user's fork.
  4. Open a PR targeting Wox-launcher/Wox.

Use a concise PR title such as Add <Plugin Name> to store.

Use a PR body that includes:

  • what plugin was added
  • the gist or repository URL
  • the download URL
  • every public screenshot URL. Stop instead of opening the PR when this list is empty

Report Back To The User

Always end with one of these outcomes:

  • Already listed: explain that no submission is needed.
  • Ready to submit: summarize the new store entry and PR URL.
  • Waiting for fork: tell the user to finish the web fork flow before continuing.
  • Blocked: list the missing metadata or missing public assets that prevented submission.

More agent skills