Botble Codex Skills

Reusable Codex skills for current Botble CMS development: plugins, themes, ecommerce, translations, APIs, seeders, testing, and code review.

The rules are aligned with the Botble AI Assistant Guide and its Laravel 13+, PHP 8.3+, and Vite-based architecture.

Available Skills

• botble-code-review
• botble-conventions
• botble-database-seeders
• botble-ecommerce
• botble-plugin-development
• botble-rest-api
• botble-testing
• botble-theme-development
• botble-translations

Install with skills.sh

List the skills detected in this repository:

npx skills add https://github.com/zakblacki/botble-codex-skills --list

Install one skill globally for Codex:

npx skills add zakblacki/botble-codex-skills --skill botble-conventions --global --agent codex

Install all nine skills globally for Codex without prompts:

npx skills add zakblacki/botble-codex-skills --skill '*' --global --agent codex --yes

Global skills are available across projects. Depending on the CLI version and sharing mode, canonical copies may appear under ~/.agents/skills/ while being registered for Codex. Verify the effective Codex inventory with npx skills ls --global --agent codex. Restart Codex if the new skills do not appear immediately.

To install from a local clone before pushing it:

npx skills add . --skill '*' --global --agent codex --yes

Important: config.toml

Do not point a [[skills.config]] entry at this repository's README.md. A skill is a directory containing SKILL.md, and global Codex installation already makes these skills discoverable. No config.toml entry is required for the installation commands above.

Manual Install

Copy any skill folder from skills/ into your Codex skills directory.

Windows:

C:\Users\<you>\.codex\skills\

macOS/Linux:

~/.codex/skills/

Install every skill manually on macOS/Linux:

mkdir -p ~/.codex/skills
cp -R skills/botble-* ~/.codex/skills/

Restart Codex after installing manually.

ChatGPT Personal Skills

Codex filesystem skills and ChatGPT Personal Skills do not sync automatically. To use these in ChatGPT web or mobile, upload each skill folder separately from Plugins > Skills > Create > Upload from computer, subject to your plan and workspace permissions.

Updating

Refresh skills installed through the CLI:

npx skills update --global

Sources

• Botble AI Assistant Guide
• Botble Vite asset compilation
• skills CLI
• OpenAI: Skills in ChatGPT