Skip to content

feat: port latest gstack skills for codex#214

Open
devwithjp wants to merge 1 commit intogarrytan:mainfrom
devwithjp:codex-port-refresh
Open

feat: port latest gstack skills for codex#214
devwithjp wants to merge 1 commit intogarrytan:mainfrom
devwithjp:codex-port-refresh

Conversation

@devwithjp
Copy link

Summary

This ports the latest upstream gstack refresh to a Codex-native skill
stack.

The main goal here is to keep Garry Tan's upstream skill system current while
making it usable from Codex without hand-maintaining divergent skill docs
every update.

What Changed

  • ported install and discovery paths from .claude/skills/gstack to .codex/ skills/gstack-codex
  • added a generated root AGENTS.md entrypoint for Codex skill discovery
  • updated the shared skill-doc generator to emit Codex-oriented output from
    the upstream templates
  • regenerated all shipped skill docs from the Codex-aware generator
  • updated browse binary discovery and local dev setup scripts for Codex
    installs
  • tightened the package test/build workflow around the Codex smoke suite
  • fixed a Linux portability issue in bin/gstack-config

Verification

  • bun run test
  • bun run build

Notes

This intentionally keeps the upstream template system as the source of truth
as much as possible, then applies Codex-specific transformation in the
generator layer. That should make future upstream refreshes much easier to
port.

The repo's full upstream bun test suite still contains Claude-specific
assertions and E2E flows, so the Codex port uses the reduced smoke suite
behind bun run test.

Credits

Full credit to Garry Tan for the original gstack concept, workflows, skill
design, and upstream implementation. This PR is a Codex-focused adaptation of
his stack, not an original workflow design.

If you want a shorter, more direct version for GitHub, use this:

Summary

Ports the latest upstream gstack update to a Codex-native skill stack.

Changes

  • switch install/discovery to .codex/skills/gstack-codex
  • generate a Codex AGENTS.md entrypoint
  • make the shared skill generator emit Codex-oriented skill docs
  • regenerate all skill docs from the latest upstream templates
  • update browse discovery and local dev setup scripts
  • fix Linux portability in bin/gstack-config

Verification

  • bun run test
  • bun run build

Credits

Credit to Garry Tan for the original gstack system and upstream
implementation. This PR adapts the latest upstream stack for Codex use.

@leoz32
Copy link

leoz32 commented Mar 20, 2026

Thanks for your contribution. However, after using your branch to the local codex, with the Gstack. It shows that

› ⚠ Skipped loading 1 skill(s) due to invalid SKILL.md files.

⚠ /Users/admin/.codex/skills/gstack-codex/SKILL.md: invalid description: exceeds
maximum length of 1024 characters

I wonder whether it would lead some errors

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants