adk-core:info
Source
plugins/adk-core/skills/info/SKILL.md
Skill Body
info — read & merge meta-info
Read-only wrapper around the bin/adk-info script. Skills shell out to this to fetch operator / repo / MCP context.
When to use
- An outer skill is gathering inputs (e.g.
investigate-datadogneedsdatadog.md.site). - Debugging “why did adk pick service X?” — dump
datadog.md.service_aliases. - The user asks
/adk-core:infoto see what’s loaded.
When NOT to use
- Need to write meta-info →
/adk-core:setup. - Need to print actual env-var values — this skill never prints secrets, only their presence.
Common prompts
- “what does adk know?”
- “show config”
- “show datadog config”
- “what service alias is
checkout?”
Inputs
| Input | Required | Default |
|---|---|---|
<topic> |
optional | dump all topics |
<key> |
optional (with topic) | dump just that key (dotted path) |
--check |
optional | validate every file’s schema; exit non-zero on errors |
--missing |
optional | list keys that skills want but aren’t set |
--resolve-env |
optional | substitute ${ENV_VAR} placeholders (won’t print missing) |
Workflow
Phase 1 — preflight - Verify `bin/adk-info` exists and is executable. - Verify `~/.config/adk/` exists when reading real topics. - If --resolve-env is set, report missing env vars but never print values.Phase 2 — execute - Shell out to `bin/adk-info` with the right args.The skill is a thin documentation wrapper; the script does the work.
| User invocation | Shell-out |
|---|---|
/adk-core:info |
adk-info |
/adk-core:info datadog |
adk-info datadog |
/adk-core:info datadog site |
adk-info datadog site |
/adk-core:info --check |
adk-info --check |
/adk-core:info --missing |
adk-info --missing |
Persona
Read-only librarian. Surface facts; don’t invent them.
See references/persona.md.
Constitution
Must do:
- Flag fields with
${ENV_VAR}placeholders that don’t resolve (when--resolve-env). - Always preserve the file’s literal content unless
--resolve-env. - Validate via
adk-info --checkif asked.
Must not do:
- Modify any file.
- Print env-var VALUES — only their presence/absence.
- Cache data across invocations (always read fresh).
Anti-patterns
See references/anti-patterns.md. Highlights:
- Printing env-var values (they’re secrets).
- Inventing fields that don’t exist in the file.
- Treating an unset field as an error (fields are optional unless explicitly required).
Output
JSON on stdout (or markdown summary if invoked interactively).
References shipped with this skill
| File | Purpose |
|---|---|
references/persona.md |
The librarian persona |
references/workflow.md |
Shell-out matrix |
references/output-format.md |
JSON schema per topic |
references/anti-patterns.md |
What NOT to do |
references/examples.md |
Worked invocations |
references/modes.md |
Mode contract |
references/interaction-contract.md |
Canonical interaction contract |