Agent skill

Tool Note And Vote

by product-on-purpose in product-on-purpose/pm-skills

Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact.

Apache-2.0Auto-check passedAgent Workflows

Install Tool Note And Vote

skills CLI
$ npx skills add product-on-purpose/pm-skills --skill tool-note-and-vote -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install product-on-purpose/pm-skills tool-note-and-vote --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/product-on-purpose/pm-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tool-note-and-vote .claude/skills/tool-note-and-vote && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tool-note-and-vote
GitHub stars
716
Token cost
~2.1k tokens
SKILL.md length
927 words
Files
4 (incl. references)
Skills in repo
68
Repo updated
First seen
Licence
Apache-2.0

At a glance

Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact.

  • Works in 5 steps: Frame the question → Silent ideation → Silent voting → …
  • A small team needs to make a fast decision with diverse input
  • SKILL.md covers When to Use, When NOT to Use, The Five-Step Protocol and Output Structure, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tool Note And Vote is an agent skill from product-on-purpose/pm-skills. 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.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `HISTORY.md`, `references/EXAMPLE.md` and `references/TEMPLATE.md`).

It sits in Agent Workflows, covering Brainstorming. The repository describes itself as: 68 plug-and-play, best-practice product management skills for AI agents: 30 Triple Diamond phase + 11 foundation + 12 utility + 15 tool (Foundation Sprint + Design Sprint). Plus… The licence is Apache-2.0.

When your agent uses it

  • A small team needs to make a fast decision with diverse input
  • Groupthink is a risk
  • A workshop moment demands silent contribution before discussion

Example prompts

  • “/tool-note-and-vote”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Frame the question
  2. Silent ideation
  3. Silent voting
  4. Brief discussion
  5. Decider supervote

What it can do on your machine

Read from SKILL.md and the folder at commit 1cef1a9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are mermaid).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • character.vc

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tool Note And Vote loads about 2.1k tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 927 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from product-on-purpose/pm-skills at commit 1cef1a9, republished under its Apache-2.0 licence (© product-on-purpose). 927 words, ~2,115 tokens.

Download SKILL.mdSave it as .claude/skills/tool-note-and-vote/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
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
metadata.version
1.0.0
metadata.updated
2026-07-04
metadata.category
coordination
metadata.frameworks
character-note-and-vote
metadata.timebox_minutes
25
metadata.roles
facilitator, decider, whole-team
metadata.inputs
decision question, time allocation, voting method, optional silent-write prompt
metadata.outputs
silent ideation board, vote summary, discussion notes, decision record
<!-- 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

text
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.

mermaid
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.

Show full SKILL.md (387 more words)Show less

Output Structure

The skill produces a single bundled artifact containing:

  1. The decision question (verbatim)
  2. The silent ideation board (all contributions, timestamped, attribution per team agreement)
  3. The vote summary (counts per option, voters per option if attribution agreed)
  4. Discussion notes (brief, the rationale that surfaced)
  5. 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:

  1. Frame the question (or approve the facilitator's framing) before silent ideation begins.
  2. Listen during discussion without dominating. The discussion's purpose is to surface what the silent vote could not.
  3. 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.

© product-on-purpose, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/tool-note-and-vote of product-on-purpose/pm-skills.

  • SKILL.md
  • HISTORY.md
  • references/EXAMPLE.md
  • references/TEMPLATE.md

Open the folder on GitHubat commit 1cef1a9

Compare with similar skills

Tool Note And Vote next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tool Note And Vote compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tool Note And Vote this skillproduct-on-purpose/pm-skills716—~2.1kAutomated safety check: PassApache-2.0
Brainstormingobra/superpowers297k1 repos~2.5kAutomated safety check: PassMIT
Brainstormingxpinjection/test-driven-spring-boot11253 repos~2.6kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Typesafe AIOpenAgentsInc/openagents4559 repos~2.5kAutomated safety check: PassMIT
Trellis StartROYIANS/foliq-print-template-designer1366 repos~646Automated safety check: PassMIT

Similar skills

  • Brainstorming

    obra/superpowers

    Makes the agent clarify intent and agree on a design with you before writing any code, scaling the process from a quick spike to a written spec.

    297k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming

    xpinjection/test-driven-spring-boot

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior.

    112 GitHub starsUsed in 53 repos~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Agent WorkflowsAuto-check passed
  • Trellis Start

    ROYIANS/foliq-print-template-designer

    Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/.

    136 GitHub starsUsed in 6 repos~646 tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from product-on-purpose/pm-skills

All 68 skills in this repo
  • Define Hypothesis

    product-on-purpose/pm-skills

    Defines a testable hypothesis with clear success metrics and a validation approach.

    716 GitHub stars~966 tokensUpdated 2 days ago
    Auto-check passed
  • Define Jtbd Canvas

    product-on-purpose/pm-skills

    Creates a Jobs to be Done canvas capturing the functional, emotional, and social dimensions of a customer job.

    716 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Define Opportunity Tree

    product-on-purpose/pm-skills

    Creates an opportunity solution tree connecting a desired outcome to customer opportunities and candidate solutions, preventing solution-first jumps in continuous discovery.

    716 GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Define Problem Statement

    product-on-purpose/pm-skills

    Creates a clear problem framing document with user impact, business context, and success criteria.

    716 GitHub stars~932 tokensUpdated 2 days ago
    Auto-check passed
  • Deliver Acceptance Criteria

    product-on-purpose/pm-skills

    Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form.

    716 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Deliver Launch Checklist

    product-on-purpose/pm-skills

    Creates a cross-functional pre-launch checklist covering engineering, design, marketing, support, legal, and operations readiness, with owners, dates, and go/no-go criteria so nothing is missed…

    716 GitHub stars~970 tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Tool Note And Vote

What does Tool Note And Vote do?

Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact. Tool Note And Vote is an agent skill from product-on-purpose/pm-skills. Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact.

When should I use Tool Note And Vote?

Tool Note And Vote fits situations like: A small team needs to make a fast decision with diverse input; groupthink is a risk; A workshop moment demands silent contribution before discussion.

How do I install Tool Note And Vote in Claude Code?

Run `npx skills add product-on-purpose/pm-skills --skill tool-note-and-vote -a claude-code`. Or copy the skill folder (skills/tool-note-and-vote in product-on-purpose/pm-skills) into .claude/skills/tool-note-and-vote in your project. Claude Code loads it when a task matches its description.

How do I install Tool Note And Vote in Codex?

Run `npx skills add product-on-purpose/pm-skills --skill tool-note-and-vote -a codex`. Or copy the skill folder (skills/tool-note-and-vote in product-on-purpose/pm-skills) into .agents/skills/tool-note-and-vote in your project. Codex loads it when a task matches its description.

Can I use Tool Note And Vote in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add product-on-purpose/pm-skills --skill tool-note-and-vote -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tool-note-and-vote, .gemini/skills/tool-note-and-vote, .github/skills/tool-note-and-vote and .opencode/skills/tool-note-and-vote in your project.

What does Tool Note And Vote need to run?

SKILL.md names no scripts, command-line tools or credentials: Tool Note And Vote is instructions for the agent only.

Does Tool Note And Vote access the network?

SKILL.md names 1 domain. As links in the text: character.vc. This is read from the text; nothing was executed.

Is Tool Note And Vote safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tool Note And Vote use?

Tool Note And Vote is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tool Note And Vote use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.

What are the alternatives to Tool Note And Vote?

Skills that share tags, products or a category with Tool Note And Vote: Brainstorming (obra/superpowers, 297k stars), Brainstorming (xpinjection/test-driven-spring-boot, 112 stars), Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars) and Typesafe AI (OpenAgentsInc/openagents, 455 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tool Note And Vote?

product-on-purpose (a GitHub organization) maintains it in product-on-purpose/pm-skills, which has 716 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on October 8, 2026.

Source: product-on-purpose/pm-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.