Chunk Skill for Codex

Chunk

Overview

Use this skill to choose the best Chunk workflow (UI or CLI), then execute it with clear prechecks and safe defaults. Keep responses action-oriented and grounded in verified commands and setup requirements.

Workflow

• Classify the request path.
• Use UI path for org setup, model-provider onboarding, fix buttons, or environment selection in the CircleCI app.
• Use CLI path for terminal-based project setup, validation hooks, prompt/context generation, sandbox operations, or scripted task execution.
• Use mixed path when users want UI setup plus CLI execution in the same flow.
• Gather minimum context.
• Confirm repository/project, branch, and whether GitHub integration is in place.
• Confirm whether the user is using CircleCI-managed model provider or bring-your-own keys.
• For CLI operations, confirm local OS compatibility and required tokens/auth.
• Execute using the matching reference.
• For UI/setup flows, load chunk-ui.md.
• For CLI flows, load chunk-cli.md.
• Close with verification.
• State what was configured or run, what remains blocked, and the next safest command or UI action.

Guardrails

• Treat Chunk features as beta unless the user confirms otherwise.
• Never expose or log secret values (API keys, tokens, bearer credentials).
• Do not invent chunk subcommands or flags; stick to documented command families.
• If sandbox features are requested, call out private preview status and any access gate.
• If a task depends on org-level prerequisites (GitHub App install, org toggles, contexts), verify those first.

Reference Map

• chunk-ui.md: CircleCI app setup, provider onboarding, fix buttons, environment file/setup, and operational troubleshooting.
• chunk-cli.md: Installation, command map, quick-start flows, auth/env variables, and platform constraints.

Output Contract

Provide:

• Path chosen (UI, CLI, or mixed) and why.
• Steps executed with exact command/UI actions.
• Required prerequisites not yet met.
• Concrete next action to finish the user’s goal.