# Governance Vote Tracker

> Description

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

---


## Description

Analyze DAO governance votes with real data from Snapshot GraphQL API or custom parameters. Provides voting power distribution, quorum verification, and automated proposal outcome prediction. Supports Aave, Uniswap, Compound, MakerDAO, Curve, and Balancer.

## Inputs (API Mode)

```json
{
  "use_api": true,
  "dao": "aave",
  "proposal_id": "123"
}
```

## Inputs (Parameter Mode)

```json
{
  "dao": "aave",
  "votes_for": 8000000,
  "votes_against": 2000000,
  "quorum": 5000000,
  "votes_abstain": 500000
}
```

## Outputs (API Mode)

```json
{
  "ok": true,
  "data": {
    "source": "snapshot_api",
    "dao": "aave",
    "proposal_id": "Qm...",
    "proposal_title": "Example Proposal",
    "proposal_state": "closed",
    "votes_for": 8000000.5,
    "votes_against": 2000000.25,
    "quorum_reached": true,
    "for_percentage": 80.0,
    "predicted_outcome": "passes",
    "recommendation": "✅ PASSES: 80.0% support",
    "check_timestamp": "2026-02-07T08:30:00Z"
  }
}
```

## Usage

### Fetch from Snapshot API
```bash
python scripts/main.py --params '{"use_api":true,"dao":"aave","proposal_id":"123"}'
```

### Analyze Custom Data
```bash
python scripts/main.py --params '{"dao":"aave","votes_for":8000000,"votes_against":2000000,"quorum":5000000}'
```

## Examples

### Example 1: Real Aave Proposal (API)
```bash
$ python scripts/main.py --params '{"use_api":true,"dao":"aave","proposal_id":"123"}'
{
  "ok": true,
  "data": {
    "source": "snapshot_api",
    "dao": "aave",
    "proposal_title": "Enable Flash Loans on Aave v3",
    "proposal_state": "closed",
    "votes_for": 8500000.0,
    "votes_against": 1500000.0,
    "quorum_reached": true,
    "for_percentage": 85.0,
    "predicted_outcome": "passes",
    "recommendation": "✅ PASSES: 85.0% support"
  }
}
```

### Example 2: Custom Parameter Analysis (Uniswap)
```bash
$ python scripts/main.py --params '{"dao":"uniswap","votes_for":5000000,"votes_against":1000000,"quorum":4000000}'
{
  "ok": true,
  "data": {
    "source": "parameters",
    "dao": "uniswap",
    "votes_for": 5000000,
    "votes_against": 1000000,
    "quorum_reached": true,
    "for_percentage": 83.33,
    "predicted_outcome": "passes",
    "recommendation": "✅ PASSES: 83.33% support"
  }
}
```

### Example 3: Failing Compound Proposal
```bash
$ python scripts/main.py --params '{"dao":"compound","votes_for":2000000,"votes_against":3000000,"quorum":4000000}'
{
  "ok": true,
  "data": {
    "source": "parameters",
    "dao": "compound",
    "votes_for": 2000000,
    "votes_against": 3000000,
    "quorum_reached": true,
    "for_percentage": 40.0,
    "predicted_outcome": "fails",
    "recommendation": "❌ FAILS: 40.0% support"
  }
}
```

## Supported DAOs

- **aave** → aave.eth (4% quorum)
- **uniswap** → uniswap (4% quorum)
- **compound** → compound (4% quorum)
- **makerdao** → makerdao (40% quorum)
- **curve** → snapshot.curve.eth
- **balancer** → balancer

## Error Handling

When an error occurs:

```json
{
  "ok": false,
  "error": "Error description",
  "details": "Additional context"
}
```