Skip to content

Trim down the agent skills, let agents auto-discover#62

Merged
mattiasgeniar merged 2 commits intomainfrom
agent-skill-improvements
Mar 16, 2026
Merged

Trim down the agent skills, let agents auto-discover#62
mattiasgeniar merged 2 commits intomainfrom
agent-skill-improvements

Conversation

@mattiasgeniar
Copy link
Copy Markdown
Contributor

Why

The agent skill was bloating context windows by inlining every CLI command with full examples (~306 lines), duplicating what the reference files and the CLI's own --help already provide. CLI-wrapping skills should teach agents to discover commands, not enumerate them.

What changed

  • Rewrote SKILL.md to use progressive disclosure: auth, discovery instructions (ohdear list / --help), output format, and pointers to reference files. 306 lines down to 65.
  • Rebuilt commands.md as a category index with key commands per group instead of exhaustive per-command tables. Added 39 previously missing commands across 6 new categories (DNS blocklists, port scanning, sitemap, recurring maintenance, status page templates, managed teams).
  • Fixed incorrect "All commands output JSON" claim everywhere (SKILL.md, commands.md, README.md) — default is human-readable text, --json is opt-in.
  • Updated stale metadata (version 5.0.0 to 5.1.3) and example dates.

@mattiasgeniar mattiasgeniar merged commit af138dd into main Mar 16, 2026
9 checks passed
@mattiasgeniar mattiasgeniar deleted the agent-skill-improvements branch March 16, 2026 20:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant