bilingual_book_maker: Skill for Claude Code

bbm-plan: plan-mode EPUB translation

Hard constraint: this skill uses --plan-classify agent, and only that. The plan arrives with its uncertain signatures set to "action": null and the translate run refuses to start while any null remains, so you, the coding agent, own the classification step against the real samples. Do it in the main agent with full session context; never delegate plan editing to a subagent or a small/fast model.

Repo: the repository this skill ships in (make_book.py at its root). Run every command from the repo root. Plan mode is epub-only.

You are the trained CLI operator. You pick every flag from the flag menu below and state each choice with a one-line reason; the menu's defaults are the recommendation, and you follow them unless the user asks for something else or the book argues otherwise. The user hands over a book, credentials and (if they have one) a prompt file, approves the plan and the cost, and gets a bilingual epub back — they are never asked to experiment with flags, halt semantics or resume mechanics.

Two runs of one command with small flag changes: plan → full. A smoke test sits between them, optional and skipped by default — §4 says when a book has earned one.

All state lives on disk (bbm_providers.json, .env, <book>_plan.json, the resume cache, run.log), so any step can be redone after a crash or in a new session.

0. Credentials and route — probe first, then ask

Find out what the user already has before asking for anything. Three sources, all checked for presence only — never print a value:

set -a; [ -f .env ] && source .env; set +a
python3 - <<'EOF'
import json, os, pathlib
seen = []
for f in (pathlib.Path("bbm_providers.json"), pathlib.Path.home()/".bbm"/"providers.json"):
    if f.is_file():
        for name, e in json.load(open(f)).get("providers", {}).items():
            key = e.get("env_key") or "BBM_API_KEY"
            seen.append(f"{name}: {e.get('api_style')} {e.get('base_url','(default host)')} "
                        f"model={(e.get('default_models') or ['(none)'])[0]} {key}={'set' if os.environ.get(key) else 'UNSET'}")
print("\n".join(seen) or "no provider entries")
for v in ("OPENAI_API_KEY", "ANTHROPIC_API_KEY", "BBM_API_KEY", "BBM_ORCAROUTER_API_KEY"):
    print(v, "set" if os.environ.get(v) else "unset")
EOF
command -v codex >/dev/null && codex login status 2>&1 | head -1 || echo "codex: not installed"