Skip to content

topness-msft/crowdhum-plugin

Repository files navigation

CrowdHum for your AI assistant

Run live audience polls without leaving the chat. Design polls from a deck or your calendar, launch them with a scan-to-vote QR code, watch votes arrive in real time, and get an AI recap. This is a portable Agent Skills + MCP plugin backed by the CrowdHum MCP server (https://mcp.crowdhum.com).

Works in Claude Code, Claude.ai (custom connector), the GitHub Copilot CLI, and any MCP client. The same package also targets Microsoft 365 Copilot / Cowork.

Requires a CrowdHum Pro account. The MCP server is Pro-gated and authenticates via OAuth on first use. No secrets live in this plugin.

What you can do

Ask your assistant in plain language:

  • "Turn this deck into a 3-question poll set, and give me the QR link to share."
  • "Run a word cloud for my standup: one word for how this sprint felt."
  • "My room code is XKCD. How did people vote, and what's the takeaway?"
  • "Given these live results, what should I poll next?"
  • "Recap the session we just ran: the themes, the splits, and one line for the stage."

What's inside

crowdhum-plugin/
├── .claude-plugin/
│   ├── plugin.json          # plugin metadata
│   └── marketplace.json     # makes this repo an installable marketplace
├── .mcp.json                # points at https://mcp.crowdhum.com (OAuth auto-negotiated)
├── color.png                # 192×192 icon
├── outline.png              # 32×32 icon
└── skills/
    ├── run-a-live-poll/     # end-to-end: create → share QR → run → results
    ├── design-a-poll/       # pick the visualization + write good choices
    ├── icebreaker-ideas/    # curated opener library, matched to the meeting
    ├── polls-from-content/  # read a deck/PDF/agenda → suggested polls
    ├── polls-from-calendar/ # read upcoming meetings → polls / icebreakers
    ├── adaptive-next-poll/  # read live results → the smart follow-up poll
    ├── session-recap/       # post-event synthesis + shareable recap
    ├── find-or-reuse-a-poll/# look up / resume / clone an existing poll
    └── invite-a-coowner/    # add a co-host to a session

Several skills compose with the host agent's own tools (reading a PowerPoint, your calendar, drafting an email). They describe the capability needed, not a specific tool, so they stay portable across hosts and degrade gracefully (they ask for pasted content when a capability isn't available).

Install (Claude)

/plugin marketplace add topness-msft/crowdhum-plugin
/plugin install crowdhum@crowdhum-plugin

Then just ask, e.g. "run a word cloud for my standup", "read this deck and suggest 3 polls", or "given these results, what should I poll next?"

Use in Microsoft 365 Copilot / Cowork

The same skills + .mcp.json convert to an M365 app package: run the Microsoft conversion script (Convert-ClaudePluginToMOS3.ps1, https://aka.ms/copilot-cowork-plugin-conversion-script), or author a manifest.json with an agentConnectors[] entry pointing at https://mcp.crowdhum.com, then package with the M365 Agents Toolkit and upload.

The MCP tools authenticate with OAuth, so the connector needs an OAuth client registration in your Microsoft tenant (a Teams Developer Portal "OAuth client registration" whose reference ID goes in the manifest's authorization block). Creating one requires tenant admin permission.

The CrowdHum MCP tools these skills use

create_poll, add_poll_to_session, get_room_links, get_poll_results, get_session, get_session_recap, list_my_sessions, list_my_polls, list_visualizations, invite_co_owner.

Visualization modes: word-cloud, column-drift, rising-bubbles, ranking, qa.

Links

License

MIT.

About

Run live CrowdHum audience polls from your AI assistant. Agent Skills + MCP plugin (Claude + Microsoft 365 Copilot/Cowork), backed by mcp.crowdhum.com.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors