> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent skills

> Install and use the Nonce and reboot-report skills with a compatible AI agent

Nonce Agent Skills let compatible agents connect to Nonce, query mining
resources, and produce operational reports from natural-language requests. The
official [agent-skills repository](https://github.com/noncehq/agent-skills)
contains two skills:

* `nonce` provides authentication, data access, code-first preprocessing,
  compact output, and guarded operational actions.
* `reboot-report` analyzes one farm's reboot activity and delivers a shareable
  HTML report.

<Note>
  For reboot reports, install both skills by default. `reboot-report` can use an
  existing authenticated Nonce connection as a fallback when `nonce` is
  unavailable or you explicitly choose that path. Use only one data path for each
  report.
</Note>

## Prerequisites

* An agent that supports Agent Skills
* A Nonce account
* Node.js with `npx` when using command-line installation

Use the current [skills.sh documentation](https://www.skills.sh/docs/cli) for
supported targets and installation behavior. The `nonce` skill checks its own
runtime and guides the agent through Nonce authorization when first used.

## Install

### Option 1: plaintext prompt (recommended)

<Prompt description="Install Nonce Agent Skills in this project and verify the installation." actions={["copy"]}>
  Follow [https://docs.nonce.app/api-guide/mcp/agent-skills-install](https://docs.nonce.app/api-guide/mcp/agent-skills-install)
  to install Nonce Agent Skills in this project
  and verify the installation.
</Prompt>

The agent may ask for permission before installing the skills or opening the
browser authorization flow.

### Option 2: npx

Install both skills for the preferred setup:

```bash theme={null}
npx skills add noncehq/agent-skills --skill nonce --skill reboot-report
```

If `nonce` is unavailable or you explicitly choose an existing authenticated
Nonce connection, install only the report skill:

```bash theme={null}
npx skills add noncehq/agent-skills --skill reboot-report
```

Follow the skills.sh prompts and documentation to choose the target and scope
for your environment.

## Connect and verify

After installation, ask your agent:

```text theme={null}
Connect me to Nonce and list my workspaces.
```

* With `nonce`, the agent follows the skill's runtime and authentication flow
  and calls `listWorkspaces`.
* With the fallback connection, the agent runs its workspace-list operation.

Installation is verified only after the selected read-only query succeeds.

<Note>
  The skills use the permissions of your Nonce account. Resolve permission errors
  through the account role or farm scope rather than broadening the query.
</Note>

## Use the skills

### Query mining resources

```text theme={null}
Show my farms and summarize the miners that are currently offline.
```

The `nonce` skill resolves the required workspace and farm identifiers, combines
data in code, and returns a compact result.

### Generate a reboot report

Include one farm, an exact time range, and a timezone:

```text theme={null}
Create a reboot analysis report for Farm A
from July 1 at 00:00 to July 8 at 00:00
in Asia/Hong_Kong.
Use the bundled HTML template and save
the completed report in this project.
```

The `reboot-report` skill uses `nonce` for data collection and preprocessing,
keeps detected reboot events separate from Nonce-issued reboot tasks, and
generates a read-only HTML report. An existing authenticated connection remains
a fallback when `nonce` is unavailable.

### Run operational actions

The `nonce` skill can perform actions that affect physical miners or operational
data. Before creating a task batch, the agent must show the exact target and
effect and receive your explicit confirmation.

## Update

### Option 1: plaintext prompt (recommended)

<Prompt description="Update the installed Nonce Agent Skills and verify the update." actions={["copy"]}>
  Follow the update workflow at
  [https://docs.nonce.app/api-guide/mcp/agent-skills-install](https://docs.nonce.app/api-guide/mcp/agent-skills-install)
  to update and verify the installed Nonce skills.
</Prompt>

### Option 2: npx

Follow the current [skills.sh documentation](https://www.skills.sh/docs/cli) to
update the installed skill set without changing its target or scope. If both
skills are installed, update both. Before updating an older `nonce`
installation, preserve any user-created files under `.nonce-skill/tasks/`
outside the installed skill directory.