plugin-creator

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

codex-rs/skills/src/assets/samples/plugin-creator/SKILL.md

Download bundle ↓
main · 18d7ace11 bundle filesScanned 2026-09-14

scripts/read_marketplace_name.py

354 tokens · o200k_base · 1,644 bytes

Source excerpt starting at line 1.
#!/usr/bin/env python3"""Print the top-level marketplace name from any marketplace.json file.""" from __future__ import annotations import argparseimport jsonimport sysfrom pathlib import Path sys.path.insert(0, str(Path(__file__).resolve().parent)) from identifier_validation import validate_marketplace_name  def default_marketplace_path() -> Path:    return Path.home() / ".agents" / "plugins" / "marketplace.json"  def parse_args() -> argparse.Namespace:    parser = argparse.ArgumentParser(        description=(            "Print the top-level marketplace name from marketplace.json. Defaults to the personal "            "marketplace path under the current home directory."        )    )    parser.add_argument(        "--marketplace-path",        default=str(default_marketplace_path()),        help="Path to marketplace.json",    )    return parser.parse_args()  def main() -> None:    args = parse_args()    marketplace_path = Path(args.marketplace_path).expanduser().resolve()    payload = json.loads(marketplace_path.read_text(encoding="utf-8"))    if not isinstance(payload, dict):        raise ValueError(f"{marketplace_path} must contain a JSON object.")    name = payload.get("name")    if not isinstance(name, str) or not name.strip():        raise ValueError(f"{marketplace_path} must contain a non-empty string 'name'.")    validate_marketplace_name(name)    print(name)  if __name__ == "__main__":    try:        main()    except Exception as err:  # noqa: BLE001 - CLI should surface a single clear message.        print(str(err), file=sys.stderr)        raise SystemExit(1) from err 
Referenced from SKILL.md