# Pollclaw

> Doodle for Agents and Humans. Create scheduling polls, share participation links, collect votes, and view results. Poll orchestration for coordinating meetings across humans and agents. Use when this capability is needed.

- Skill: `tomevault-io/pollclaw` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pollclaw`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pollclaw/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pollclaw

---


# Pollclaw - Meeting coordination for Agents and Humans

Like Doodle - but for agents and humans. Create a poll, share a link, collect votes, find the best time.

## Understanding the Model

### Two Tokens, Two Purposes

When you create a poll, you receive two tokens:

- **Admin token** (`adm_...`) — Keep this private. You need it to view full results, see who voted, and close the poll. Store it in your memory for the poll's lifetime.

- **Participate token** (`prt_...`) — Share this freely. Anyone with the participate URL can vote. Works for humans (web UI) and agents (API). Multiple people use the same link.

### Choosing Time Slots

Ask your user what times work for them. They can tell you their availability, and you'll create the poll with those options.

### Sharing the Poll

Give the participate URL to your user and ask them to share it with participants. "Here's the poll link — please forward it to the team."

You can suggest an invitation message like:

```
Hi [name/team],

[Creator name] has created a poll to find the best time for [meeting purpose].

Vote here: [participate URL]

Please submit your availability by [deadline if any].
```

### Email Verification

Poll creation requires a verified email (one-time per email, valid for 30 days of activity).

Use `?autoVerify=true` when creating:

```
POST /api/v1/polls?autoVerify=true
```

If unverified, this automatically sends the verification email and returns:
```json
{
  "error": {
    "code": "email_not_verified",
    "details": { "verificationSent": true, "email": "user@example.com" }
  }
}
```

Tell the user: "Check your email and click the verification link, then let me know."

Poll `GET /api/v1/auth/status?email=...` until `verified: true`, then retry poll creation.

After verification, subsequent polls create immediately (no verification needed for 30 days of activity).

## Quick Examples

```
"Create a poll for our team standup next week"
"How many people have voted?"
"Close the poll and pick the best time"
```

## API

Fetch the OpenAPI spec for endpoint details:

- **OpenAPI spec:** https://pollclaw.ai/api/v1/openapi.json
- **Interactive docs:** https://pollclaw.ai/docs
- **AI plugin manifest:** https://pollclaw.ai/.well-known/ai-plugin.json

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/demerzels-lab) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->