Random number generator

Skill zazencodes/random-number-skills/skills/random-number-generator

Random number generator agent skill using Python standard library

Install

npx -y skills add zazencodes/random-number-skills --skill random-number-generator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generate random numbers with Python standard library utilities. Use when asked for a random number generator agent skill, RNG, random integer, random float, dice roll, random choice, weighted random choices, list shuffle, sample without replacement, secure random integer, cryptographic randomness, secure token, random password candidate, password entropy, or hex token.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.8 KB, as published. Nobody here has run it

Random Number Generator

Overview

Generate random values by running the bundled Python script from this skill. The script uses only Python's standard random and secrets modules and prints JSON by default so results are easy to parse.

Execution Rule

Run commands from this skill directory, so scripts/random_number.py resolves relative to this SKILL.md. If the shell is not already in the skill directory, change into the directory containing this file first.

Prefer Python launchers in this order:

python3
py -3 on Windows
python only after confirming it is Python 3

If Python 3 is unavailable, tell the user that this skill requires Python 3 and do not fake a random result.

Quick Start

python3 scripts/random_number.py random-int --low 1 --high 100 --raw

On Windows PowerShell:

py -3 scripts/random_number.py random-int --low 1 --high 100 --raw

Use --raw when presenting a single scalar value directly to the user. Omit --raw when you want JSON output for reliable parsing.

Commands

Random integer, inclusive bounds:

python3 scripts/random_number.py random-int --low 1 --high 6 --raw

Random float:

python3 scripts/random_number.py random-float --low 0 --high 1 --raw

Choices with replacement:

python3 scripts/random_number.py random-choices --population-json '["red","blue","green"]' --k 2

Weighted choices with replacement:

python3 scripts/random_number.py random-choices --population-json '["red","blue","green"]' --weights-json '[5,2,1]' --k 3

Shuffle a list:

python3 scripts/random_number.py random-shuffle --items-json '[1,2,3,4,5]'

Sample without replacement:

python3 scripts/random_number.py random-sample --population-json '["a","b","c","d"]' --k 2

Secure hex token:

python3 scripts/random_number.py secure-token-hex --nbytes 16 --raw

Secure integer from 0 up to but not including upper-bound:

python3 scripts/random_number.py secure-random-int --upper-bound 1000 --raw

Choosing Secure vs Standard Randomness

Use secure-token-hex or secure-random-int for new random password candidates, tokens, invite codes, or any user request that mentions secure, cryptographic, crypto-safe, token, random password, password entropy, or password.

Do not use this skill to accept, store, transform, validate, or repeat existing passwords, API keys, bearer tokens, cookies, or credentials. Only generate new random values on direct user request.

Use the standard random commands for dice, games, simulations, sampling, shuffling, randomized examples, and everyday random selection.

JSON Input

Pass lists through JSON flags such as --population-json, --items-json, and --weights-json. In Bash, zsh, and PowerShell, wrap JSON in single quotes as shown above. For shells that do not support single quotes, escape the double quotes or use a shell that does.

Output

Default output is JSON. Examples:

42
["red", "green"]
"<secure-hex-output>"

With --raw, scalar strings and numbers are printed without JSON quoting. Use raw output only when the command returns a scalar; list outputs remain JSON.

Available Script

scripts/random_number.py - Command-line wrapper around Python random and secrets standard-library functions. Run python3 scripts/random_number.py --help for the full interface.