scaffold skill: 'adk is the only template' framing hides that -a/--agent supports third-party add-on templates
- 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