google / google/agents-cli

scaffold skill: 'adk is the only template' framing hides that -a/--agent supports third-party add-on templates

Aperta Adatta ai principianti
#86 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
documentation
Lingua principale
Python
Stelle
5.9k
Fork
660
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

**Is your feature request related to a problem? Please describe.**

`--agent`/`-a` on `scaffold create` already accepts a remote Git spec (`org/repo/path@ref`) that layers a third-party add-on's manifest and starter files over the `adk` base template (`scaffold/utils/remote_template.py`'s `parse_agent_spec`). This is documented generically in `references/flags.md` ("or remote Git URL"), but the `google-agents-cli-scaffold` skill's "adk is the only template" framing gives no indication the mechanism exists or how it'd be used for a real integration. A coding agent following the skill today would never discover or suggest it, even though it works correctly.

I ship one of these myself (a Keel resilience add-on for ADK agents: `MisterTK/keel/packaging/agents-cli-template`), and only found the CLI still supported this cleanly by reading the source, not the skill.

**Describe the solution you'd like**

I'd tried opening a PR with the exact doc change, but pull requests appear to be disabled on this repo, so posting the proposed diff here instead in case it's useful to apply directly.

In `skills/google-agents-cli-scaffold/SKILL.md`, right after the existing "`adk` is the only template" blockquote:

```markdown
### Layering a Vendor/Community Add-on

`--agent`/`-a` also accepts a remote Git spec (`org/repo/path@ref`) that layers a
vendor or community add-on's manifest and starter files over the `adk` base
template — a separate mechanism from the architecture choice above, and the
way a third-party library ships opinionated scaffolding (extra dependencies,
starter config) without agents-cli needing to know about it in advance.
Example: `keelrun` (zero-code retry/timeout/breaker/cache policy for ADK
agents) ships one:

\`\`\`bash
agents-cli scaffold create my-agent -a MisterTK/keel/packaging/agents-cli-template
\`\`\`

See `references/flags.md`'s `--agent` row for the full spec syntax.
```

And in `skills/google-agents-cli-scaffold/references/flags.md`, the `--agent` row's description gains one clause: `... or remote Git URL (`org/repo/path@ref` — also used to layer a vendor/community add-on's manifest + starter files over a base template, e.g. `MisterTK/keel/packaging/agents-cli-template`)`.

**Describe alternatives you've considered**

Leaving it undocumented — but that means the mechanism stays effectively invisible to anyone (human or coding agent) relying on the skill rather than reading the CLI's own source.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Leggi skills/google-agents-cli-scaffold/SKILL.md e references/flags.md, quindi ispeziona scaffold/utils/remote_template.py, in particolare parse_agent_spec, per confermare la sintassi Git remota. Il lavoro è completo quando entrambi i documenti delle skill spiegano che --agent può sovrapporre un add-on di un vendor o della community al template di base adk, includono l’esempio fornito e rimandano alla sintassi completa dei flag.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
cli, documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Attiva
Chiarezza
Specificata chiaramente
Idoneità per principianti
92/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.