A workflow for adding or adapting reusable Codex skills to your global configurations.
Install
mkdir -p .claude/skills/global-skill-creator && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/19109" && unzip -o skill.zip -d .claude/skills/global-skill-creator && rm skill.zipInstalls to .claude/skills/global-skill-creator
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Create global Codex skills distributed through this dotfiles repository. Use when adding reusable Codex workflows under config/codex/skills or adapting a project-local skill for global use.Key capabilities
- →Scaffold new global Codex skills
- →Add skills to `config/codex/skills/` directory
- →Ensure valid Codex frontmatter and trigger language
- →Integrate validation tests for new skills
- →Provide concrete invocation examples
How it works
The skill creates a new global Codex skill directory with `SKILL.md` frontmatter, incorporates trigger language and instructions, and adds it to the validation test suite. It ensures the skill is project-agnostic and provides an invocation example.
Inputs & outputs
When to use global-skill-creator
- →Creating a new global skill
- →Adapting local skills for global use
- →Testing Codex skills
About this skill
Global Skill Creator
Goal
Create a portable global Codex skill under config/codex/skills/.
Success means the skill has valid Codex frontmatter, useful trigger language, focused instructions, optional resources only when they add value, and a passing local validator run.
Stop when the skill is created or updated, validation passes, and the user has a concrete invocation example.
Workflow
- Read the current Codex skill-authoring instructions exposed in the session, then inspect an active tracked skill and
tests/test-codex-skills.sh. Do not depend on the system-managed, gitignoredconfig/codex/skills/.systemdirectory. - Ask for the skill's reusable purpose, trigger scenarios, and whether it needs references, scripts, templates, or assets.
- Create
config/codex/skills/<skill-name>/with a matchingSKILL.mdfrontmattername. - Use concise
descriptiontext that front-loads the key task and trigger words. - Keep detailed docs in
references/, deterministic helpers inscripts/, and output resources inassets/. - Add
agents/openai.yamlwhen UI metadata or explicit-invocation policy is useful. Keep it to the supportedinterfaceandpolicyfields used by active skills. - Add the skill to the expected inventory in
tests/test-codex-skills.shand run:
./tests/test-codex-skills.sh
- Run
make test-prefor every global skill change.
Dotfiles Context
This repository tracks global Codex skills in config/codex/skills. scripts/link-config.sh links that directory into ${CODEX_HOME:-~/.codex}/skills.
Keep global skills project-agnostic. Use .codex/skills for workflows that only make sense inside this dotfiles repository.
When not to use it
- →When creating project-local skills
- →When depending on system-managed, gitignored directories
- →When the skill is not intended for global distribution
Limitations
- →Skills must be project-agnostic
- →Does not depend on system-managed, gitignored directories
- →Requires `make test-pre` for every global skill change
How it compares
This skill provides a structured workflow for creating and validating global Codex skills, ensuring consistency and portability across the development environment, unlike ad-hoc skill creation.
Compared to similar skills
global-skill-creator side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| global-skill-creator (this skill) | 0 | 12d | Review | Intermediate |
| command-development | 16 | 8mo | Review | Intermediate |
| skill-forge | 11 | 8mo | Review | Intermediate |
| codex-skill | 12 | 4mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by wcygan
View all by wcygan →You might also like
command-development
anthropics
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
skill-forge
WilliamSaysX
Automated skill creation workshop with intelligent source detection, smart path management, and end-to-end workflow automation. This skill should be used when users want to create a new skill or convert external resources (GitHub repositories, online documentation, or local directories) into a skill. Automatically fetches, organizes, and packages skills with proactive cleanup management.
codex-skill
feiskyer
Use when user asks to leverage codex, gpt-5, or gpt-5.1 to implement something (usually implement a plan or feature designed by Claude). Provides non-interactive automation mode for hands-off task execution without approval prompts.
agent-factory
alirezarezvani
Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns
subagent-driven-development
davila7
Use when executing implementation plans with independent tasks in the current session
peekaboo
openclaw
Capture and automate macOS UI with the Peekaboo CLI.