tool-note-and-vote
Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact
Install / Use
npx skills add product-on-purpose/pm-skills --skill tool-note-and-voteInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Project & Program ManagementSupported Platforms
Our assessment of tool-note-and-vote
tool-note-and-vote scores 89/100 on our quality scale, 17th of 80 Project & Program Management skills we index (top 22%).
Its SKILL.md is 8.3 KB long, well organised into 14 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 697 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 16 days ago, so tool-note-and-vote is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
tool-note-and-vote compared with similar skills
All 4 of these similar skills score higher than tool-note-and-vote; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| tool-note-and-vote (this skill)by product-on-purpose | 89 | 697 | 16d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 11d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 11d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 130.2k | 13d ago | SKILL.md |
| ui-ux-pro-maxby nextlevelbuilder | 100 | 130.2k | 13d ago | SKILL.md |
Frequently asked questions
- How do I install tool-note-and-vote?
- Run
npx skills add product-on-purpose/pm-skills --skill tool-note-and-vote. The install tabs above show the steps for each supported agent. - Which AI agents does tool-note-and-vote work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is tool-note-and-vote safe to use?
- It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is tool-note-and-vote still maintained?
- The repository was last updated 16 days ago, so tool-note-and-vote is actively maintained.
Skill content
View source on GitHubname: tool-note-and-vote description: Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact. Use when a small team needs to make a fast decision with diverse input, when groupthink is a risk, or when a workshop moment demands silent contribution before discussion. Applicable to Foundation Sprint, Design Sprint, and any participatory decision context. license: Apache-2.0 metadata: classification: tool version: "1.0.0" updated: 2026-07-04 category: coordination frameworks: - character-note-and-vote timebox_minutes: 25 roles: - facilitator - decider - whole-team inputs: - decision question - time allocation - voting method - optional silent-write prompt outputs: - silent ideation board - vote summary - discussion notes - decision record author: product-on-purpose
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->Note-and-Vote
Run a structured group decision in 20-30 minutes. Silent contribution surfaces independent thinking before group dynamics narrow the option space; explicit Decider supervote closes the choice. Produces a written audit trail of the decision and the alternatives considered.
When to Use
- A small team (3-10 people) needs to make a fast decision with diverse input.
- Groupthink, status bias, or loudest-voice dominance is a real risk.
- A workshop or meeting moment demands silent ideation before open discussion.
- The decision needs an audit trail (what was considered, why the chosen option won).
- Decision authority is clear (a Decider exists and is in the room or available).
- Used heavily across Foundation Sprint and Design Sprint at decision moments.
When NOT to Use
- A single person owns the decision and just needs to make it. Use direct judgment.
- Consensus has already emerged organically. The voting overhead adds friction without value.
- The decision is high-stakes enough to warrant longer deliberation (multi-day investigation, written proposals, formal review). Note-and-Vote is a 25-minute tool, not a governance process.
- No Decider is available and the team has no authority to close the decision themselves. Defer until a Decider can attend.
The Five-Step Protocol
1. Frame the question (1-2 min)
2. Silent ideation (3-7 min, depending on complexity)
3. Silent voting (2-5 min, multi-vote or single-vote)
4. Brief discussion of the vote distribution (5-10 min)
5. Decider supervote (1 min)
Total: 12-25 minutes depending on time allocations. Default is 25 minutes for a non-trivial decision.
flowchart TB
Start([Decision needed])
Start --> S1[Step 1: Frame the question<br/>1-2 min, spoken]
S1 --> S2[Step 2: Silent ideation<br/>3-7 min, silent]
S2 --> S3[Step 3: Silent voting<br/>2-5 min, silent]
S3 --> S4[Step 4: Brief discussion<br/>5-10 min, spoken]
S4 --> S5{Step 5: Decider supervote<br/>1 min}
S5 -->|Most common| TopVote[Pick top vote-getter]
S5 -->|Sometimes| Override[Pick different option<br/>with stated rationale]
S5 -->|Rare| Revote[Call re-vote after re-framing]
TopVote --> Record[Decision recorded in artifact]
Override --> Record
Revote --> S2
style S2 fill:#e1f5ff
style S3 fill:#e1f5ff
style S5 fill:#fff4e1
style Record fill:#e1ffe1
Silent steps (blue) protect against anchoring. The Decider supervote (amber) has three legal outcomes; the loop back to silent ideation is the recovery path when the framing was wrong.
Step 1: Frame the question
Write the decision question on the board, one sentence, unambiguous. Examples:
- "Which target customer segment should our Foundation Sprint commit to for Day 1?"
- "Which solution sketch goes forward into Wednesday's storyboard?"
- "Which sprint question should be the primary scorecard row on Friday?"
Bad framings to avoid:
- Compound questions ("which customer AND problem")
- Yes/no questions (use a different tool)
- Open exploration ("what should we do?")
Step 2: Silent ideation
Every participant contributes options silently and independently. Sticky notes on a wall, cells in a Miro board, or rows in a shared doc. No talking. No reading others' contributions until the timer ends.
The facilitator MUST enforce silence. Verbal contribution defeats the purpose.
Step 3: Silent voting
Display all contributions anonymously (or with attribution if the team has agreed). Each participant gets N votes (often 2-3 for a multi-vote round, 1 for a single-vote tiebreaker). Vote silently using dots, stickers, reactions, or numbers. No discussion during voting.
Step 4: Brief discussion
Surface the top 2-3 vote-getters. Each person who voted for the top options briefly explains why. The facilitator times this (5-10 minutes max). If discussion expands beyond the top options, the facilitator pulls it back.
This is the place where the team can detect surprises ("I didn't realize we were aligned on X") or unsurprises ("we're split between A and B for known reasons"). It is not the place to relitigate the framing.
Step 5: Decider supervote
The Decider names the chosen option. The Decider may pick the top vote-getter (most common), pick a different option with stated rationale (sometimes), or call for a re-vote after the discussion (rare).
The supervote is the decision. Record it explicitly in the artifact. Do not let the supervote blur into continued discussion; the team needs to see the close.
Output Structure
The skill produces a single bundled artifact containing:
- The decision question (verbatim)
- The silent ideation board (all contributions, timestamped, attribution per team agreement)
- The vote summary (counts per option, voters per option if attribution agreed)
- Discussion notes (brief, the rationale that surfaced)
- The decision record (chosen option + Decider name + Decider rationale if non-obvious)
See references/TEMPLATE.md for the canonical structure and references/EXAMPLE.md for a worked example using the Brainshelf book-catalog Foundation Sprint thread.
Common Pitfalls
- Skipping silent ideation. "Let's just discuss it" defeats the protocol. The team produces what they would have produced without the tool.
- Skipping Decider supervote. Consensus drift. The discussion ends without a recorded decision.
- Long discussion phase. Five-minute discussions become twenty-minute debates. The facilitator must time-box and pull back.
- Compound or vague framing. "What should we do about X?" is not a decidable question. Reframe before invoking.
- Voting without seeing the contributions. If contributions are revealed during ideation, the voting is anchored to the first idea seen. Enforce silence.
- Treating the Decider's choice as advisory. The supervote is the decision; if the Decider does not have authority, the wrong person is in the Decider seat.
Decider Role
The Decider has three responsibilities in Note-and-Vote:
- Frame the question (or approve the facilitator's framing) before silent ideation begins.
- Listen during discussion without dominating. The discussion's purpose is to surface what the silent vote could not.
- Supervote with explicit rationale when the supervote diverges from the team's top choice.
A Decider who consistently rubber-stamps the team's top vote is not adding value. A Decider who consistently overrides without rationale is not building trust. Both are signals the wrong person is in the seat.
Canonical Source
Character Capital publishes the canonical Note-and-Vote guide at https://www.character.vc/guide/note-and-vote. Knapp and Zeratsky describe Note-and-Vote variants in both Sprint (Design Sprint context) and Click (Foundation Sprint context).
This pm-skills implementation follows the Character protocol with the Five-Step structure named explicitly.
Cross-Family Usage
tool-note-and-vote is a standalone tool, not a member of any sprint family. It is invoked many times across both foundation-sprint-skills and design-sprint-skills family members at decision moments. SKILL.md files in those families reference tool-note-and-vote inline rather than embedding the protocol.
The skill is also useable outside sprint contexts: any participatory decision in a meeting, planning session, or workshop can invoke it.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
130.2kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
ui-ux-pro-max
130.2kUI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
