crypto-governance-guide
Skill8 starsChanged 9 months agoMITView on GitHub
Guide to DAO governance — voting mechanics (token-weighted, veToken, quadratic), proposal processes, delegation, and governance participation best practices. Covers Snapshot, on-chain governance, and real examples including Sperax, Aave, and Uniswap.
In this repository45 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms-full.txtllms.txt
- llms.txtllms.txt
- sperax-skillsSkill
- agent-wallet-securitySkill
- ai-agent-defi-guideSkill
- airdrop-hunting-guideSkill
- arbitrum-defi-guideSkill
- chainlink-oracle-guideSkill
- cross-chain-bridge-guideSkill
- crypto-market-sentimentSkill
- crypto-news-aggregationSkill
- crypto-portfolio-managementSkill
- crypto-price-data-guideSkill
- crypto-tax-basicsSkill
- dca-strategy-guideSkill
- defi-dashboard-buildingSkill
- defi-lending-guideSkill
- defillama-analytics-guideSkill
- defi-risk-assessmentSkill
- defi-yield-strategiesSkill
- erc8004-agent-identitySkill
- gas-optimization-guideSkill
- impermanent-loss-explainedSkill
- mev-protection-guideSkill
- nft-analytics-guideSkill
- onchain-analytics-guideSkill
- plutus-plsassets-guideSkill
- plutus-protocol-overviewSkill
- plutus-vaults-guideSkill
- restaking-explainedSkill
- smart-contract-reading-guideSkill
- sperax-ecosystem-overviewSkill
- sperax-farms-guideSkill
- sperax-spa-stakingSkill
- sperax-usds-guideSkill
- stablecoin-mechanicsSkill
- subgraph-development-guideSkill
- token-approval-safetySkill
- token-discovery-guideSkill
- token-swap-best-practicesSkill
- web3-glossarySkill
- whale-watching-guideSkill
- yield-vault-guideSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 128
For voters: Don't need to track every proposal
- Distinctive: line 134
When helping users evaluate proposals, consider:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Crypto Governance Guide
DAOs (Decentralized Autonomous Organizations) use various governance models to make protocol decisions. This guide helps AI agents assist users with governance participation.
Governance Models
Token-Weighted Voting
Most common model: 1 token = 1 vote.
| Protocol | Token | Voting Platform |
| Uniswap | UNI | On-chain + Snapshot |
| Aave | AAVE/stkAAVE | On-chain |
| Compound | COMP | On-chain |
Pros: Simple, aligns economic incentives Cons: Whale-dominated, low participation
Vote-Escrowed (veToken)
Lock tokens for governance power. Longer lock = more power.
| Protocol | Token | Lock Period | Power Formula |
| Sperax | SPA → veSPA | 7d–4y | veSPA = SPA × (days/365) |
| Curve | CRV → veCRV | 1w–4y | veCRV = CRV × (days/365) |
| Balancer | BAL → veBAL | 1w–1y | veBAL = BAL × (days/365) |
Pros: Aligns long-term incentives, reduces mercenary governance Cons: Capital lock-up, decaying voting power
Quadratic Voting
Vote weight = √(tokens). Reduces whale dominance.
| Protocol | Implementation |
| Gitcoin | Quadratic funding for grants |
Pros: More egalitarian Cons: Sybil-vulnerable without identity verification
Optimistic Governance
Proposals pass unless vetoed within a timeframe.
| Protocol | Implementation |
| Optimism | Token House + Citizens' House |
Pros: Faster execution, less voter fatigue Cons: Requires active monitoring
Governance Lifecycle
Typical Process
Idea → Discussion → Proposal → Vote → ExecutionSperax Governance (Example)
| Phase | Action | Duration |
| Phase 0 | Discord ideation | Open-ended |
| Phase 1 | Forum SIP proposal | 48h minimum discussion |
| Phase 2 | Snapshot vote | 3 days, veSPA-weighted |
| Phase 3 | Engineering implementation | Varies |
Requirements:
- Quorum: 200M veSPA
- Passing: >50% Yes votes
- Snapshot: https://snapshot.box/#/s:speraxdao.eth
Aave Governance (Example)
| Step | Action |
| ARC | Aave Request for Comments (forum) |
| AIP | Aave Improvement Proposal (formal) |
| Vote | On-chain vote (AAVE + stkAAVE weighted) |
| Timelock | 24h delay before execution |
| Execute | Automated on-chain execution |
Voting Platforms
Snapshot (Off-Chain)
- What: Gasless voting via signed messages
- Used by: Most DAOs for governance votes
- Cost: Free (no gas to vote)
- Security: Relies on social consensus for execution
On-Chain Governance
- What: Votes recorded on blockchain
- Used by: Compound, Aave, Uniswap (binding votes)
- Cost: Gas for each vote
- Security: Enforced by smart contracts
Tally
- What: Governance dashboard for on-chain proposals
- Used by: Compound, Aave, Uniswap, and many others
- URL: https://tally.xyz
Delegation
Many DAOs allow vote delegation — give your voting power to a delegate who votes on your behalf.
How It Works
- Choose a delegate whose values align with yours
- Delegate your voting power (you keep your tokens)
- Delegate votes on proposals on your behalf
- You can undelegate at any time
Benefits
- For voters: Don't need to track every proposal
- For DAOs: Higher effective participation
- For delegates: Build reputation in governance
Proposal Analysis
When helping users evaluate proposals, consider:
Impact Assessment
| Factor | Questions |
| Scope | How big is this change? |
| Risk | What could go wrong? |
| Reversibility | Can it be undone? |
| Precedent | Does it set a precedent? |
| Economic Impact | How does it affect token holders? |
Red Flags in Proposals
- Extremely short voting periods
- Vague or poorly specified changes
- Large treasury spending without detailed budget
- Changes that benefit proposer disproportionately
- Governance parameter changes (quorum, timelock)
- Emergency proposals without clear emergency
Agent Tips
- Explain the proposal in plain language before recommending a vote
- Check quorum requirements — if a vote won't reach quorum, it doesn't matter
- Review discussion — what did the community say in forums?
- Delegation — recommend delegates for users who can't track every vote
- veToken mechanics — explain the lock-up tradeoff (more power vs less liquidity)
- Sperax governance — SPA → veSPA with weekly rewards makes governance participation profitable
Links
- Sperax Governance: https://snapshot.box/#/s:speraxdao.eth
- Snapshot: https://snapshot.org
- Tally: https://tally.xyz
- Sperax Docs: https://docs.sperax.io
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

