From a08f0de53b089014ad815addac6e7f7cc8dece36 Mon Sep 17 00:00:00 2001 From: Justin Stottlemyer Date: Wed, 13 May 2026 23:29:02 -0700 Subject: [PATCH] docs(skill): clarify that no provider API key is read for semantic extraction MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Several host agents (Claude Code in particular) misread the current phrasing and prompt the user for `ANTHROPIC_API_KEY` when no Gemini key is set, instead of falling through to subagent dispatch. The Gemini tip stays as-is; this just adds an explicit one-line callout that no other provider keys are consulted, with `ANTHROPIC_API_KEY` called out by name since that is the specific misread we hit in the wild. No behavior change — pure documentation. --- graphify/skill.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/graphify/skill.md b/graphify/skill.md index 228af383..89b8a859 100644 --- a/graphify/skill.md +++ b/graphify/skill.md @@ -207,6 +207,8 @@ This step has two parts: **structural extraction** (deterministic, free) and **s Print it once, then continue. If `GEMINI_API_KEY` or `GOOGLE_API_KEY` IS set, use `graphify.llm.extract_corpus_parallel(files, backend="gemini")` for semantic extraction instead of dispatching Claude subagents. The default Gemini model is `gemini-3-flash-preview`; set `GRAPHIFY_GEMINI_MODEL` or pass `--model` in headless CLI flows to override it. +> **No other API keys are read.** If `GEMINI_API_KEY`/`GOOGLE_API_KEY` are unset, fall straight through to Claude Code subagent dispatch (Part B below) — the host session itself is the LLM. graphify does **not** read `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, or any other provider key from the environment. If a host agent prompts the user for `ANTHROPIC_API_KEY` to run extraction, that prompt is a misread of this skill — ignore it and dispatch subagents as written. + **Run Part A (AST) and Part B (semantic) in parallel. Dispatch all semantic subagents AND start AST extraction in the same message. Both can run simultaneously since they operate on different file types. Merge results in Part C as before.** Note: Parallelizing AST + semantic saves 5-15s on large corpora. AST is deterministic and fast; start it while subagents are processing docs/papers.