Instruction file imported from sx-tane/context-os (
.github/instructions/customization.instructions.md). Copyright stays with the author.
Customization Authoring Instructions
Skill
For the full authoring workflow, skeletons, wiring rules, and completion checklist, apply the contextos-authoring skill.
Customization Shape
- Skills live at
.github/skills/<name>/SKILL.mdand.codex/skills/<name>/SKILL.mdmirrors; keepassets/andreferences/subdirectories aligned with the procedure. - Add
scripts/only when the skill has an executable helper; do not create empty script placeholders. - Agents wire skills with a skill reference, skeleton link, checklist link, and inline fallback rules.
- Instruction files stay short and point to the paired skill for deep implementation detail.
Documentation Checklist
- Update
.codex/README.md,AGENTS.md, and the relevant.github/agents/README.mdor.github/instructions/README.mdwhen agent, instruction, skill, routing, or folder structure behavior changes. Do not add a top-level.github/README.mdonly to satisfy benchmarks. - Update the nearest folder README when the customization changes how files in that folder should be edited.
- Keep links to skeletons, checklists, examples, and scripts valid after every rename or move.
Do Not
- Do not duplicate long skill procedures inside instruction files.
- Do not leave skill reference tables stale after adding or renaming a skill.
- Do not add unused script placeholders when no executable helper exists.