Design lean skill instructions
Write precise descriptions, keep SKILL.md focused, route specialized detail into references, and avoid duplicated guidance.
Codex Skills to Reduce Token Usage help Codex load less irrelevant context while keeping the instructions and evidence a task actually needs. Download the skills for progressive disclosure, focused file discovery, compact references, bounded outputs, transcript compaction, tool-result filtering, and efficient verification.
task: complete token-efficient codex workflows task
inspect:
- requirements and context
- existing standards
- failure and edge cases
verify: outputs + checks + handoffCodex skills can keep their initial name and description small, then load full instructions only when selected and open supporting references only when required.
These skills reduce waste by defining narrow triggers, staged context gathering, concise evidence, reusable scripts, and explicit stopping conditions rather than cutting essential reasoning.
Write precise descriptions, keep SKILL.md focused, route specialized detail into references, and avoid duplicated guidance.
Start from the requested outcome, search for relevant symbols or files, read tight sections, and expand only when evidence requires it.
Filter logs, cap tool output, summarize stable findings, reuse saved artifacts, and avoid repeating unchanged information.
Track decisions and remaining work, compact transcripts at useful boundaries, separate independent investigations, and finish with concise verification.
The steps keep context, implementation, and verification visible so the result can be reviewed and repeated.
Identify the decision to make, minimum inputs, likely source files, required evidence, and output length before reading broadly.
Load the core workflow first, then open only the reference, script, file section, or result needed for the current step.
Record paths, constraints, decisions, and failures once so later steps can refer to a compact state instead of replaying raw output.
Run proportionate checks, report essential evidence, and avoid additional exploration that cannot change the result.
The workflow adjusts to the project, audience, tools, and risk while preserving the same quality standard.
Use targeted search, dependency tracing, file maps, and scoped checks instead of loading entire trees.
Keep discovery descriptions concise and distribute detailed knowledge across optional references and scripts.
Maintain compact decisions, checkpoints, and handoffs while removing resolved conversational noise.
Filter logs, query results, traces, diffs, and documents to the slices that answer the current question.
Start with one defined outcome and provide the source material, constraints, and checks that matter.
These skills are designed for people who need dependable token-efficient codex workflows work with a visible process.
Spend context on the task rather than repeated setup and unrelated files.
Use progressive disclosure and narrow triggers without weakening the workflow.
Make investigation and verification scale through focused search and compact evidence.
Keep recurring and long-running workflows predictable, bounded, and auditable.
Reducing token usage should not remove required safety checks, hide uncertainty, skip relevant source material, or force a low-context answer when the task genuinely needs broader analysis.
Install the complete skill folder and add the project-specific context before beginning.
Keep its progressive disclosure, search, filtering, compaction, and stopping guidance together.
Use user scope for general context habits or repository scope for project-specific discovery and checks.
Add small maps for commands, architecture, ownership, terminology, and verification instead of repeating them in every task.
Compare task success, missing-context failures, correction loops, tool output, and token consumption on representative work.
Practical answers about capabilities, limits, setup, and review.
No. They reduce avoidable context and output, while actual usage still depends on the task, model, tools, and conversation.
It means loading concise discovery information first and opening detailed instructions or references only when the task needs them.
No. Keep the core workflow complete, then move specialized detail, examples, and large references into files loaded on demand.
It can free context during long work by preserving important decisions in a shorter form, but it should happen at a sensible checkpoint.
Yes, if important context or checks are removed. The goal is to cut repetition and irrelevant material, not necessary evidence.
Clear context. Purposeful work. Relevant checks. A result others can understand.