# Vote Close

> Record the result of a Helium Release Proposal community vote. Updates the HRP status to Approved (or back to Proposed if the vote failed), adds the vote URL, and updates the README with the result. Use when the user says "the vote passed", "record the vote result", "close the vote", "the vote is done", "update the HRP with the vote result", or mentions a heliumvote.com URL for an HRP. Also handles cancelling a vote that never started (reverting Frozen back to Proposed).

- Skill: `helium/vote-close` (Agent Skill)
- Install (CLI): `npx skillmds@latest add helium/vote-close`
- Raw SKILL.md: https://api.skillmd.com/api/skills/helium/vote-close/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: helium (https://skillmd.com/u/helium)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/helium/vote-close

---


# HRP Vote Close Skill

You record the outcome of a Helium Release Proposal community vote and update all the
tracking surfaces — the release file and the README.

This skill also handles the "vote cancelled" case where the vote never actually started
(e.g. the helium-vote PR was rejected or the multisig didn't sign).

## Steps

### 1. Identify the target HRP

- Find the HRP with `status: Frozen` — this is the one with an active or recently completed vote
- If the user specifies a month, find that specific HRP file
- Read the full release file

**Status guard:** This skill only operates on `Frozen` HRPs. If the HRP has a different status:
- `Proposed` → "This HRP hasn't been frozen for voting yet. Run `/hrp:vote-open` first."
- `Approved` → "This HRP's vote result has already been recorded."
- `Released` → "This HRP has already been released."

### 2. Look up vote results from chain

Run the lookup script to get the vote URL and results directly from the on-chain proposal:

```bash
"${CLAUDE_PLUGIN_ROOT}/scripts/lookup-vote-url.sh" --month "{YYYY-MM}" --results
```

This returns JSON with `url`, `publicKey`, `forPercent`, `againstPercent`, and `totalVeHNT`.

**If the script returns an error** (proposal not found or RPC failure), fall back to asking the user for the vote URL and percentage manually.

**If the frontmatter already has a `vote-url`**, use that instead of querying the chain.

### 3. Determine the outcome

Use the on-chain results to determine the outcome automatically:
- **forPercent >= 67** → vote passed (meets the approval threshold)
- **forPercent < 67** → vote failed

Present the results to the user for confirmation: "The on-chain vote shows {forPercent}% approval ({totalVeHNT} veHNT). Record this as [passed/failed]?"

If the user says the vote was **cancelled** (never went live), skip to step 4c.

### 4a. If vote passed

The vote URL and percentage come from the lookup script. The date defaults to today unless the user specifies otherwise.

Update frontmatter:
- `status: Approved`
- `vote-url: {heliumvote.com URL}`

Update README — insert a new line into the vote history list. The list lives between the intro paragraph and the "How to Contribute" section. Insert at the top of the list (newest first), matching the existing format exactly:

```
- HRP {YYYY-MM} passed with [{X}% of the vote]({vote-url}) on {Month Dth Year}
```

### 4b. If vote failed

Same data sources as 4a (URL, percentage from lookup script).

Update frontmatter:
- `status: Proposed` (reverts to allow further changes)
- `vote-url: {heliumvote.com URL}` (kept for historical record)
- Remove `vote-summary-url` and `vote-pr` fields

Update README — same insertion point as 4a:

```
- HRP {YYYY-MM} failed with [{X}% of the vote]({vote-url}) on {Month Dth Year}
```

### 4c. If vote cancelled

No vote URL, percentage, or date needed.

Update frontmatter:
- `status: Proposed` (reverts to allow further changes)
- Remove `vote-summary-url` and `vote-pr` fields

Do **not** update the README — nothing to record if no vote happened.

### 5. Commit and report

Commit directly to `main` (the release file should already be on main by this point). Include both the release file and README (if changed) in a single commit:

- Passed: `Record HRP {Month Year} vote result: approved with {X}%`
- Failed: `Record HRP {Month Year} vote result: failed with {X}%`
- Cancelled: `Revert HRP {Month Year} to Proposed (vote cancelled)`

Tell the user:
- What was updated
- Next step:
  - Passed: "Deploy the release, then run `/hrp:release` to record the deployment date."
  - Failed: "The HRP is back in Proposed status. You can revise it and run `/hrp:vote-open` again when ready."
  - Cancelled: "The HRP is back in Proposed status. The vote artifacts (gist, helium-vote PR) may need manual cleanup."