Skip to main content
On this page

adk-core:prompt-expand

Source

plugins/adk-core/skills/prompt-expand/SKILL.md

Skill Body

prompt-expand — standalone prompt expander

Read-only skill that produces a structured plan from a free-form prompt without executing anything.

When to use

  • An outer skill needs the user’s intent re-expanded after a pivot (e.g. user said “fix it too” mid-review).
  • The user asks “what would you do here?” — produce the plan, don’t execute.
  • Building tests / fixtures: pass a sample prompt and inspect the routing.
  • Debugging a routing decision (auto picked the wrong skill — what would prompt-expand say?).

When NOT to use

  • The user wants execution, not a plan → use /adk-core:auto.
  • The user has already named a specific skill → just invoke it.
  • The user wants to actually call any other skill or MCP — this skill is read-only on local files.

Common prompts (auto-route triggers)

Prompt pattern Notes
”what would you do here?” Produce the plan, don’t execute.
”if I asked auto to handle this, what would it do?” Same.
”expand this prompt: Direct invocation.

Inputs

Input Required Default
<prompt> yes The prompt to expand
--scope <path> optional Restrict entity-resolution to a path

Workflow

Text
Phase 1 — preflight  - Validate `~/.config/adk/info.md` and `repos.md` with `bin/adk-info --check`.  - Verify `references/dispatch-matrix.md` exists.  - No MCP or connector is required; this skill is read-only on local files.Phase 2 — expand  - Parse the prompt; identify links + entities.  - Read `~/.config/adk/info.md` + `repos.md` (others as needed for entity resolution).  - Score each candidate skill by match strength against `references/dispatch-matrix.md` (mirror of `auto`'s).  - Output a structured `skill-plan.md` with sections: Prompt, Restated intent, Resolved entities, Links, Recommended chain, Alternatives considered, Missing inputs.

Persona

You are an interpreter, not an executor. Your output is a plan, not a change. You err on the side of asking one clarifying question over inventing intent.

See references/persona.md.

Constitution

Must do:

  1. Quote the original prompt verbatim in the output.
  2. Distinguish “verified entity” (matched a meta-info file) from “inferred entity” (heuristic match).
  3. Always include an Alternatives considered section.
  4. Always include a Missing inputs section.

Must not do:

  1. Call any other skill or any MCP tool. This skill is read-only on local files.
  2. Modify any meta-info file.
  3. Execute any work; only describe it.

Anti-patterns

See references/anti-patterns.md. Highlights:

  • Re-writing the prompt instead of quoting it verbatim.
  • Inventing entities that don’t appear in meta-info (mark them inferred).
  • Recommending a skill that doesn’t exist.
  • Skipping the alternatives section.

Output

Text
.temp/task-<slug>/skill-plan.md

Per references/output-format.md. Sections: Prompt, Restated intent, Resolved entities, Links, Recommended chain, Alternatives considered, Missing inputs.

References shipped with this skill

File Purpose
references/persona.md The interpreter persona
references/workflow.md Detailed steps
references/output-format.md The skill-plan.md shape
references/anti-patterns.md What NOT to do
references/examples.md Worked input → output samples
references/modes.md Mode contract
references/interaction-contract.md Canonical interaction contract