Agent skills hide information in unspecified field #1010

Priority Level

Low (Cosmetic / Minor)

Describe the bug

The agent skills in the repo are using a field called argument-hint to specify usage instructions. This is not part of the official agent skill specification and thus won't transfer as well to all harnesses.

Steps/Code to reproduce bug

Refer to the official agent skills specification:

• https://agentskills.io/
• or https://github.com/agentskills/agentskills

Expected behavior

It would be desirable to keep divergence from the Agent Skills spec to a minimum, so that degradation between harnesses is minimized.

How to fix (PR here):

• Remove argument-hint and describe the invocation in description in natural language, with literal values quoted.

Agent Diagnostic / Prior Investigation

No response

Additional context

How to fix (PR here):

• Remove argument-hint and describe the invocation in description in natural language, with literal values quoted.

Checklist

• I reproduced this issue or provided a minimal example
• I searched the docs/issues myself, or had my agent do so
• If I used an agent, I included its diagnostics above