scaffold skill: 'adk is the only template' framing hides that -a/--agent supports third-party add-on templates
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 92/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- python
- Domain
- cli, documentation
Research direction
Read skills/google-agents-cli-scaffold/SKILL.md and references/flags.md, then inspect scaffold/utils/remote_template.py, especially parse_agent_spec, to confirm the remote Git syntax. Done means both skill documents explain that --agent can layer a vendor or community add-on over the adk base template, include the provided example, and point to the full flag syntax.
Written by the indexing model from the issue text.
Description
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:
### 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.
- Dominant language
- Python
- Stars
- 6k
- Forks
- 670
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from google/agents-cli
-
google/agents-cli#89 · 1 assignee ·
-
google/agents-cli#87 · 1 comment · 1 assignee ·
-
Difficulty 3/5 1-2 days Newbie friendliness 68/100
google/agents-cli#85 · 1 comment ·
-
Difficulty 3/5 1-2 days Newbie friendliness 68/100
google/agents-cli#84 · 1 comment ·
-
Difficulty 3/5 1-2 days Newbie friendliness 72/100
google/agents-cli#83 · 2 comments · 1 reaction ·
All issues in google/agents-cli
Similar issues
-
documentation help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
simonw/sqlite-utils#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100