Skip to content

Port content improvements from Claude Code authstack#5

Closed
saif-at-scalekit wants to merge 1 commit into
mainfrom
cross-pollinate/codex-content-improvements
Closed

Port content improvements from Claude Code authstack#5
saif-at-scalekit wants to merge 1 commit into
mainfrom
cross-pollinate/codex-content-improvements

Conversation

@saif-at-scalekit
Copy link
Copy Markdown
Contributor

What

Ports content patterns from the Claude Code authstack to Codex. Since Codex has no rules system (.mdc or equivalent), terminology and principles are inlined in skill mental model sections instead of separate rule files.

Changes (8 files, +82 lines)

Mental model sections (2 skills)

  • agent-auth/skills/agent-auth/SKILL.md: Connector/connection/connected-account/tool hierarchy + live-metadata-first principle
  • full-stack-auth/skills/full-stack-auth/SKILL.md: OIDC/OAuth 2.0 provider model

"When to switch skills" routing tables (all 8 entry skills)

Added to: agent-auth, building-agent-mcp-server, integrating-agent-auth, full-stack-auth, mcp-auth, modular-sso, modular-scim, production-readiness-scalekit

Deep reference backlinks (2 skills)

  • building-agent-mcp-server/SKILL.md: Links to connected-accounts, connections, code-samples, byoc
  • production-readiness-scalekit/SKILL.md: Links to connected-accounts, connections, byoc

Bug fixes

  • Removed stale beta SDK version pin (@scalekit-sdk/node@2.2.0-beta.1@scalekit-sdk/node)
  • Fixed broken CONNECTORS.md link → references/agent-connectors/README.md
  • Removed broken token-management.md reference (file does not exist)

Validation

python3 scripts/validate_marketplace.py passes.

Skill improvements across all 5 plugins:
- Add mental model sections (agent-auth, full-stack-auth)
- Add 'When to switch skills' routing tables (all 8 entry skills)
- Add deep reference backlinks (building-agent-mcp-server, production-readiness)
- Remove stale beta SDK version pin (agent-auth, mcp-auth)
- Fix broken CONNECTORS.md link (agent-auth)
- Remove broken token-management.md reference (agent-auth)

Codex has no rules system, so terminology and principles are
inlined in the mental model sections instead of separate rule files.
@saif-at-scalekit
Copy link
Copy Markdown
Contributor Author

Superseded by #6 which includes these content improvements plus the 5→2 AgentKit/SaaSKit consolidation.

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