Problem
CLI option naming is inconsistent across commands:
| Command |
Flag |
Type |
install |
--agent |
Array |
install |
--skills,--skill,-s |
String (comma-separated) |
generate |
--agents |
(plural) |
manifest |
--agents |
(plural) |
translate |
--to |
(different pattern entirely) |
Users must remember different flag names per command.
Proposed Solution
Standardize on:
--agent (singular, Array type) — consistent with install command
--skill (singular, with -s shorthand) — filter by skill name
- Accept both
--agent and --agents as aliases for backwards compatibility
- Deprecation warning for
--agents: "Use --agent instead (--agents will be removed in v2.0)"
Files to Update
packages/cli/src/commands/generate.ts — --agents → --agent
packages/cli/src/commands/manifest.ts — --agents → --agent
- Any other commands using plural form
Acceptance Criteria
Problem
CLI option naming is inconsistent across commands:
install--agentinstall--skills,--skill,-sgenerate--agentsmanifest--agentstranslate--toUsers must remember different flag names per command.
Proposed Solution
Standardize on:
--agent(singular, Array type) — consistent with install command--skill(singular, with-sshorthand) — filter by skill name--agentand--agentsas aliases for backwards compatibility--agents: "Use --agent instead (--agents will be removed in v2.0)"Files to Update
packages/cli/src/commands/generate.ts—--agents→--agentpackages/cli/src/commands/manifest.ts—--agents→--agentAcceptance Criteria
--agent(singular) as primary flag--agentsaccepted as deprecated alias--agentsis used