Question 200
A shared deployment skill accepts a target environment and a release version, but developers invoke it as /deploy without arguments and it fails after starting. Which SKILL.md frontmatter field improves discoverability of the required invocation parameters?
Explanation
Correct Answer
Claude Code's argument-hint field displays expected parameters in invocation autocomplete, helping developers understand the skill's required inputs before they run it. The skill should also validate those inputs in its workflow and refuse ambiguous production deployments. The hint improves discoverability, but it is not a schema validator or an authorization mechanism by itself. The team must ensure the selected Claude Code environment supports this frontmatter, since packaging outside Claude Code may apply different permitted metadata fields.
Incorrect Answers
A changing release identifier is an invocation argument, not an enduring identity for the workflow. Renaming skills for each release makes the command catalog unstable and harder to maintain. Parameter hints are better suited to variable inputs. A stable command name should describe its ongoing purpose.
A tool description is not the right location for a skill's command syntax, and API key metadata must not expose deployment secrets. Invocation guidance should be associated with the skill itself. Runtime approval still governs actual deployments. Authentication data must remain outside the model-visible interface.
Implicit production selection is unsafe when different environments have different effects. The workflow should request and validate an explicit target, particularly for destructive or externally visible actions. Showing the expected parameters reduces accidental invocations. Production changes should remain subject to explicit authorization and validation.