From d5d2a64c32440d975002910f7d575675ddf49c4d Mon Sep 17 00:00:00 2001 From: Gregory Schier Date: Wed, 9 Sep 2026 08:50:26 -0700 Subject: [PATCH] fix(cli): focus the agent skill description on when to use it (#625) --- crates-cli/yaak-cli/skills/use-yaak/SKILL.md | 21 +++++++------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/crates-cli/yaak-cli/skills/use-yaak/SKILL.md b/crates-cli/yaak-cli/skills/use-yaak/SKILL.md index 030c7a99..007713e7 100644 --- a/crates-cli/yaak-cli/skills/use-yaak/SKILL.md +++ b/crates-cli/yaak-cli/skills/use-yaak/SKILL.md @@ -1,19 +1,12 @@ --- name: use-yaak description: > - Build and run HTTP API requests with the Yaak CLI (`yaak`): create workspaces, - folders, environments and variables, author HTTP requests, configure - authentication (OAuth 2.0, bearer tokens, API keys, basic, JWT, AWS SigV4), - send them individually or a whole folder/workspace at once, chain one - request's response into the next, and import existing APIs from OpenAPI, - Postman, Insomnia, or cURL. Use this skill whenever the user mentions Yaak, a - Yaak workspace, or the `yaak` command, and also when they ask to try, hit, - call, exercise, or smoke test an HTTP or REST endpoint, to save or organize - API requests for reuse, to set up API requests for manual testing, to add auth - to a saved request, to turn an OpenAPI or Postman collection into runnable - requests, or to run a saved request suite against staging versus production. - Prefer this over one-off `curl` commands whenever the requests should be - saved, reused, shared, or run as a set. + Use when the user mentions Yaak, a Yaak workspace, or the `yaak` command, or + asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API + requests for reuse or manual testing, configure auth on saved requests, import + an OpenAPI spec, a Postman or Insomnia collection, or a cURL command, or run + saved requests across environments. Prefer over one-off `curl` when requests + should be saved, reused, shared, or run as a set. allowed-tools: Bash(yaak:*), Bash(which:*), Bash(command:*), Bash(npm:*), Bash(npx:*) --- @@ -34,7 +27,7 @@ only for publishing plugins to the Yaak registry. Two consequences worth holding onto. Requests you create are permanent user data in an app they use, not scratch files, so name them the way the user would and clean up anything created just to test. And because the app is right there, the -CLI is usually the wrong place to *read* a response in detail; it is the right +CLI is usually the wrong place to _read_ a response in detail; it is the right place to build, organize, and run requests. ## The CLI describes itself