ask
The `ask` skill delegates tasks to CCB (Claude Codex Bridge) agents when collaboration or external execution is needed. Use it when a user requests delegation, project memory indicates CCB collaboration, or work requires separation from the current Claude instance. The skill includes a decision framework for choosing response intent (silence, compact, artifact, callback) and request fidelity (artifact-request, artifact-io) based on whether results are needed, how results should be formatted, and whether exact input preservation matters.
git clone --depth 1 https://github.com/SeemSeam/claude_codex_bridge /tmp/ask && cp -r /tmp/ask/inherit_skills/droid_skills/ask ~/.claude/skills/askSKILL.md
Use this when the user asks you to delegate with CCB, or when project memory
says to use CCB `ask` for collaboration.
## Decision Card
Before every ask, decide:
1. Need delegation? If no, answer directly.
2. Result intent:
- `--silence`: publish/execute task; success result not needed. Failures,
blockers, risks, or required next actions still surface.
- `--compact`: result wanted, but only distilled
findings/status/risks/blockers/next actions.
- `+ --artifact-reply`: consultation/analysis/report where full text should
be preserved.
- plain `ask`: short question or short handoff where inline text is enough.
- `--callback`: active CCB parent job + child result required to finish.
Combine with `--compact` or `--artifact-reply` as needed. Submit, then
stop for continuation.
3. Request fidelity:
- `+ --artifact-request`: exact transient input
(logs/output/diffs/copied contents/config/JSON/YAML/table/structured text).
Prefer repo paths when the target can read files directly.
- `--artifact-io`: request and reply both need artifacts.
## Guardrails
- Do not probe `--callback`; if unsure there is an active parent job, use plain
`ask`.
- If CCB says `ask --callback requires an active parent job`, retry once with
plain `ask` for user-requested delegation.
- `--callback` and `--silence` usually conflict; avoid mixing unless explicit.
- Avoid `--silence --artifact-reply`; silence means no caller result needed; artifact-reply preserves one.
- Artifact flags are orthogonal to `--callback`, `--silence`, and `--compact`.
They preserve content, not dependency shape.
- Automatic spill for text over 4 KiB is a fallback, not the primary rule.
- `--artifact-*` modes are CCB/daemon managed; targets do not write artifact reply files.
- Plain nested `ask` from an active CCB task is rejected; use `--callback` or `--silence`.
- In `A --silence -> B`, B still runs an active job. B-to-C depends on whether B needs C's result.
- In callback chains, each waiting hop uses callback; CCB then propagates continuations.
- `ask get`, `pend`, `watch`, and `ping` are diagnostics-only commands for
explicit debugging requests, not normal ask workflow tools.
- Do not manually append output-policy text; `ask` injects reply guidance.
Always send `MESSAGE` through the `<<'EOF' ... EOF` heredoc below. No other form
is allowed. Use no flags or insert selected flags before `"$TARGET"`:
```bash
command ask "$TARGET" <<'EOF'
$MESSAGE
EOF
```
```bash
command ask --callback --artifact-reply "$TARGET" <<'EOF'
$MESSAGE
EOF
```
After the command returns, end the turn. Do not wait for a reply,
do not run `ask get` / `pend` / `ping` / `watch`, do not poll.
For `--callback`, report only that delegation was submitted.Maintain this CCB project's GitHub-facing release and npm publication surface. Use when preparing, publishing, auditing, or fixing CCB releases; updating README.md, README_zh.md, CHANGELOG.md, VERSION, package.json, GitHub release notes/assets, repository description/topics, npm registry state, or GitHub Actions release/test status.
Private built-in CCB configuration skill for agentroles.ccb_self. Design, edit, validate, and prepare reloads for .ccb/ccb.config, role bindings, providers, windows, workspaces, tool windows, sidebar, and provider startup inputs. Use only inside ccb_self; non-self agents should delegate CCB config changes to ccb_self.
Diagnose and repair CCB ask/job/message/reply/artifact/callback lineage. Use for missing replies, incomplete artifacts, pending callbacks, retry/resubmit/ack decisions, reply delivery problems, or work-chain resume advice.
Diagnose CCB runtime, mounted daemon graph, tmux namespace and panes, provider context, queue/inbox/trace, replies/artifacts, config drift, and storage boundaries. Use when the user asks what is broken, which agent is stuck, whether CCB is mounted, why a reply did not arrive, or what to check first.
Recover CCB agents, panes, mounts, provider contexts, API/provider failures, config reload aftermath, clear operations, and guarded single-agent restarts. Use when the user asks to fix, recover, restart if safe, clear context, reload, remount, or keep work going after provider/API failure.
Clear CCB managed agent conversation context with `ccb clear`. Use when the user writes `$ccb-clear`, `$ccb_clear`, or asks to clear/reset one or more CCB agent contexts without restarting or deleting project state.
Maintain a structured planning document tree made of roadmap/status files, implementation status or handoff TODO files, topic notes, decision records, open questions, ideas/inspiration pools, and repository/file-structure hygiene plans. Use when Codex needs to create, reorganize, audit, or update a multi-file plan, design-doc folder, roadmap tree, active implementation-status file, repo cleanup/filesystem plan, ADR/decision log, ideas inbox, or linked planning knowledge base; reconcile Done/In Progress/Next state; resume work from TODO/handoff state; move resolved questions into decisions; promote ideas into formal plan artifacts; or keep plan documents and file-structure planning internally consistent without making this project-specific.