- Keep skills concise.
- Keep Codex-native instructions in
skills/. - Do not copy Claude-specific boilerplate from upstream
gstack. - Preserve workflow value, not source formatting.
- Pull or update your local
gstackcheckout. - Run:
python3 scripts/sync_from_gstack.py status --source <gstack-path>
python3 scripts/sync_from_gstack.py scaffold-new --source <gstack-path>- Review any newly generated folders under
scaffolds/. - Promote the useful ones into curated skills under
skills/. - Update
mappings/skills.jsonwhen a scaffold becomes a curated skill.
- Frontmatter should be minimal and precise.
- Put detailed knowledge in references only when it materially improves repeatability.
- Prefer workflow instructions over slogans.
- Mention when the skill should stop and surface uncertainty.
Run:
python3 scripts/check_repo.pyTo install or refresh links into your Codex setup:
python3 scripts/sync_from_gstack.py install --target ~/.codex/skills