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 % <sides> + 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) <noreply@anthropic.com>
This commit is contained in:
Jonathan Hefner
2026-03-23 11:24:28 -05:00
Unverified
parent d91d26d0ab
commit d7dba49441
+3 -3
View File
@@ -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-<sides> -n 1
echo $((RANDOM % <sides> + 1))
```
```powershell