add-to-global-trigger/SKILL.md
Route proposed additions to the global Codex control plane by deciding whether a request belongs in `~/.codex/AGENTS.md`, a global workflow or reference doc under `~/.codex/docs`, `~/.codex/bin/workflow.py`, or an enforceable non-prose surface. Use when asked to "add this to global AGENTS", "promote this workflow to global", "add a new global trigger", or decide whether something should be a trigger, workflow, reference, hook, lint rule, or runtime guard.
npx skillsauth add ingpoc/skills add-to-global-triggerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use this skill to add or refuse additions to the global Codex trigger layer without blurring surface ownership. Decide the owner surface first, then edit only the surfaces the request actually needs.
Global scope only:
~/.codex/AGENTS.md~/.codex/docs/~/.codex/bin/workflow.pyDo not use this skill for repo-local AGENTS.md work.
workflow summary placement.AGENTS.md for a short, stable routing rule that points to an existing durable target.docs/workflows/ for a runtime multi-step process.docs/references/ or docs/quality-gate/ for authoring guidance, checklists, or validation rules.skills/ when the request is a reusable method with judgment.~/.codex/AGENTS.md last.If the request is longer than three short lines of stable instruction, do not put the full content in AGENTS.md. Create or update the owning surface and add only a compact trigger.
Run targeted retrieval before editing:
workflow list
workflow search "<topic>"
rg -n "<topic>|<candidate-name>" ~/.codex/AGENTS.md ~/.codex/docs ~/.codex/skills -g '*.md'
Collapse duplicates instead of creating parallel guidance. If an existing doc or skill already owns the concept, update that surface rather than adding a new one.
Choose this path only when all of the following are true:
workflow summary <doc> or another existing surfaceBefore editing ~/.codex/AGENTS.md, run:
workflow summary agentmd-quality-gate
Choose a new doc when the trigger needs a durable target.
Before creating the doc, run:
workflow summary workflow-doc-creation
Do not describe global doc creation as a reindex task. Global docs are discovered by filesystem scan.
Edit ~/.codex/bin/workflow.py only when the new doc needs first-class short-name support through workflow summary <name>, workflow read <name>, or other alias-based routing.
Before changing workflow.py, run:
workflow summary workflow-cli-quality-gate
Measure before and after for the command path you changed. Treat alias support as a CLI surface change, not just a doc change.
Do not add prose when the request is really about blocking or mechanically steering behavior. Prefer:
rumdl for recurring Markdown misuseruff for recurring Python misuseIf you route to enforcement, explain briefly why the request should not become a global trigger or doc.
Follow this order exactly:
workflow summary placementworkflow summary workflow-doc-creation and author the docworkflow summary workflow-cli-quality-gate and update ~/.codex/bin/workflow.pyAGENTS.md, workflow summary agentmd-quality-gate~/.codex/AGENTS.mdUse the exact command sequences in surface-matrix.md.
Always validate the surfaces you touched.
~/.codex/AGENTS.md changed:
workflow registryworkflow lint~/.codex/bin/workflow.py changed:
workflow lintworkflow lint --fullpython3 -m unittest discover -s /Users/gurusharan/.codex/tests -p 'test_workflow_cli_regression.py'workflow summary <alias> worksIf workflow registry shows unrelated pre-existing drift, report it but do not fix it unless the requested change depends on it.
Refuse or reroute when:
devops
Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.
tools
Design or review CLIs so both coding agents and humans can use them reliably: dual-audience output, non-interactive paths, layered help, machine-readable data, predictable flags, safe mutations, and actionable errors. Use when building a CLI, adding commands, writing --help, or when the user mentions agents, terminals, automation-friendly CLIs, JSON output, or headless usage.
tools
Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read/write commands, return stable JSON, manage auth, and pair with a companion skill.
development
Use when configuring apps to use z.ai GLM 4.7 proxy instead of standard Anthropic API. Works with any frontend (Next.js, Vite) or backend (Python, Node.js) framework.