discuss-questions

Scans GitHub Discussions General category and posts grounded replies to community questions.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/witwave-ai/witwave --skill discuss-questions-witwave-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discuss-questions
Source: https://github.com/witwave-ai/witwave/tree/main/.agents/self/piper/.claude/skills/discuss-questions
Command: npx skills add https://github.com/witwave-ai/witwave --skill discuss-questions-witwave-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Community members post open-ended questions in the GitHub Discussions General category, and without an automated responder those questions about the team's code, decisions, and platform behavior go unanswered or get speculative replies. This Skill monitors the General category each heartbeat tick and posts factual, code-grounded answers on behalf of the team. ## Core Features & Use Cases - Guarded engagement pipeline: Applies moderation pre-screening, author filtering, engagement-signal gates, already-replied checks, and per-thread cooldowns (5-minute minimum, 5 replies/day cap) before drafting any reply. - Code-grounded investigation: Reads the source tree, git log/blame, peer findings, and the team decision log to answer questions with cited SHAs, file paths, and decision entries rather than speculation. - Register-matched replies: Matches the conversational register of each comment, from one-line pleasantries to substantive technical answers, and routes bug reports to the Bugs category or recurring misconceptions to the docs-improvement queue. - Use Case: A user asks in General why the harness uses port 8000 while backends use 8010-8012; the Skill reads AGENTS.md and chart values, then posts a reply citing the exact configuration source. ## Quick Start Ask the agent to check the general questions in GitHub Discussions and reply where it can add grounded value.

Frequently Asked Questions about discuss-questions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically reply to GitHub Discussions questions?▼

Use the gh api graphql CLI to list discussions in a category, filter threads with engagement guards, and post replies via the addDiscussionComment mutation. This Skill runs that flow each heartbeat tick against the General category.

How to prevent an AI agent from over-replying in discussion threads?▼

Apply layered guards: skip self-authored comments, require an external trigger since the last reply, enforce a per-thread cooldown, and cap daily replies per thread. This Skill uses a 5-minute cooldown and a 5-replies-per-day limit.

Can the agent answer technical questions about the codebase?▼

Yes. It reads the local source checkout, git log and blame output, peer findings files, and the team decision log to ground answers, citing commit SHAs, file paths, and decision entries so humans can verify claims.

What happens when a General post is actually a bug report?▼

The agent replies briefly redirecting the author to the Bugs category instead of investigating in General. It does not file issues or write bug-tracking entries from General content; category routing stays with the user.

Why does the agent stay silent on some discussion threads?▼

Silence is the default when a reply adds no value: duplicate questions better handled elsewhere, questions directed at a specific peer, humans already in productive conversation, or bare mentions without a question. Deferred threads are logged with a reason marker.