AgentSkillsCN

enact/dice-roll-rust

掷骰子,可配置面数和数量——一个简单的Rust示例工具

SKILL.md
--- frontmatter
name: enact/dice-roll-rust
version: 1.0.0
description: Roll dice with configurable sides and count - a simple Rust example tool
enact: "2.0"

from: rust:1.75-slim

build:
  - rustc -o /workspace/dice /workspace/dice.rs

command: /workspace/dice ${sides} ${count}

timeout: 60s

license: MIT

tags:
  - dice
  - random
  - rust
  - example
  - games

inputSchema:
  type: object
  properties:
    sides:
      type: integer
      description: Number of sides on each die (e.g., 6 for a standard die, 20 for a d20)
      default: 6
      minimum: 2
      maximum: 100
    count:
      type: integer
      description: Number of dice to roll
      default: 1
      minimum: 1
      maximum: 100

outputSchema:
  type: object
  properties:
    rolls:
      type: array
      items:
        type: integer
      description: Array of individual roll results
    total:
      type: integer
      description: Sum of all dice rolls
    sides:
      type: integer
      description: Number of sides on each die
    count:
      type: integer
      description: Number of dice rolled

examples:
  - input:
      sides: 6
      count: 2
    description: Roll two standard 6-sided dice
  - input:
      sides: 20
      count: 1
    description: Roll a single d20 (classic tabletop gaming)
  - input:
      sides: 6
      count: 4
    description: Roll 4d6 (common for D&D character stats)

Dice Roll (Rust)

A simple dice rolling tool written in Rust. Demonstrates how to create an Enact tool with Rust.

Features

  • Roll any number of dice with configurable sides
  • Returns individual rolls and total sum
  • Supports common dice types: d4, d6, d8, d10, d12, d20, d100

Usage Examples

CLI

Roll a single d6

bash
enact run enact/dice-roll-rust

Roll 2d6 (two six-sided dice)

bash
enact run enact/dice-roll-rust -a '{"sides": 6, "count": 2}'

Roll a d20

bash
enact run enact/dice-roll-rust -a '{"sides": 20}'

Roll 4d6 for D&D stats

bash
enact run enact/dice-roll-rust -a '{"sides": 6, "count": 4}'

MCP (for LLMs/Agents)

When using via MCP, call enact__dice-roll-rust with:

  • sides: Number of sides per die (default: 6)
  • count: Number of dice to roll (default: 1)

Output

Returns JSON with:

  • rolls: Array of individual die results
  • total: Sum of all rolls
  • sides: The die type used
  • count: Number of dice rolled