From d7dba49441cf8bca618cdf1dba3889a02de3954c Mon Sep 17 00:00:00 2001 From: Jonathan Hefner Date: Mon, 23 Mar 2026 11:24:28 -0500 Subject: [PATCH] Replace `shuf` with `$RANDOM` in quickstart for broader compatibility `shuf` is a GNU coreutil which requires `brew install coreutils` on macOS. Replace it with `echo $((RANDOM % + 1))` which works in bash and zsh on both Linux and macOS. Also reword "true randomness" to "using a random number generator" to more clearly distinguish programmatic RNG from LLM non-determinism. Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/skill-creation/quickstart.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/skill-creation/quickstart.mdx b/docs/skill-creation/quickstart.mdx index 448a826..8947828 100644 --- a/docs/skill-creation/quickstart.mdx +++ b/docs/skill-creation/quickstart.mdx @@ -3,7 +3,7 @@ title: "Quickstart" description: "Create your first Agent Skill and see it work in VS Code." --- -In this tutorial, you'll create a skill that gives an agent the capability to roll dice using true randomness. +In this tutorial, you'll create a skill that gives an agent the capability to roll dice using a random number generator. ## Prerequisites @@ -20,14 +20,14 @@ A skill is a folder containing a `SKILL.md` file. VS Code looks for skills in `. ````markdown .agents/skills/roll-dice/SKILL.md --- name: roll-dice -description: Roll dice with true randomness. Use when asked to roll a die (d6, d20, etc.), roll dice, or generate a random dice roll. +description: Roll dice using a random number generator. Use when asked to roll a die (d6, d20, etc.), roll dice, or generate a random dice roll. --- To roll a die, use the following command that generates a random number from 1 to the given number of sides: ```bash -shuf -i 1- -n 1 +echo $((RANDOM % + 1)) ``` ```powershell