2 Commits

• 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>

  Jonathan Hefner · 2026-03-23 11:25:26 -05:00
  d7dba49441
• Add quickstart guide for skill creators

  Adds a tutorial-style quickstart guide that walks the reader through
  creating their first Agent Skill — a `roll-dice` skill that teaches an
  agent to roll dice using true system randomness. The guide covers
  creating the `SKILL.md` file, verifying discovery via `/skills` in VS
  Code, testing with a "Roll a d20" prompt, and a brief explanation of the
  discovery/activation/execution lifecycle. Includes both bash and
  PowerShell command variants, and a note about model variation in
  tool-use reliability.
  
  Also adds the quickstart as the first page under "For skill creators" in
  `docs.json` navigation.
  
  Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

  Jonathan Hefner · 2026-03-16 10:35:35 -05:00
  3fccd701c1