builtwithcodex

Publish a Codex skill to Built with Codex from Codex or the terminal.

Usage

Publish the current skill repo:

npm i -g builtwithcodex
builtwithcodex --path "$PWD"

The global install also copies the Codex skill to:

~/.codex/skills/builtwithcodex

Attach docs/demo URL:

builtwithcodex \
  --url "https://github.com/you/your-skill#readme" \
  --repo-url "https://github.com/you/your-skill"

Publish from a GitHub skill repo URL:

builtwithcodex \
  --repo-url "https://github.com/you/your-skill"

Install a marketplace skill into Codex:

npx --yes builtwithcodex install check-code

Human skill names work too:

npx --yes builtwithcodex install "Check Code"

You can also pass a skill page URL:

npx --yes builtwithcodex install "https://builtwithcodex.online/p/check-code"

Use a custom Built with Codex instance:

builtwithcodex \
  --path "$PWD" \
  --marketplace-url "https://launchboard.example.com"

Add explicit fields:

builtwithcodex \
  --path "$PWD" \
  --demo-url "https://github.com/you/your-skill#readme" \
  --screenshot-url "https://raw.githubusercontent.com/you/your-skill/main/screenshot.png" \
  --codex-skill-url "https://github.com/you/your-skill"

Preview without opening the browser:

builtwithcodex --path "$PWD" --no-open

From Codex

After this package is published to npm, users can tell Codex:

Use the builtwithcodex npm package to publish this Codex skill.

The package opens a prefilled Built with Codex submit page. The user still signs in with GitHub and confirms publish, so ownership, limits, and payments stay enforced by the marketplace.

By default, the package opens:

https://builtwithcodex.online

Bundled Codex Skill

The npm package includes the Codex skill files under:

skill/

That makes the package both a CLI and a distributable skill payload.