external-comms

Drafts GitHub issue and discussion responses with mandatory human review before posting.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/codebytes/btt --skill external-comms-codebytes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: external-comms
Source: https://github.com/codebytes/btt/tree/main/.squad/templates/skills/external-comms
Command: npx skills add https://github.com/codebytes/btt --skill external-comms-codebytes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Responding to community issues and discussions is time-consuming and risky when done inconsistently or without full thread context. This Skill provides a structured PAO (Public Affairs Officer) workflow that scans open GitHub issues and discussions, drafts on-brand responses from reusable templates, and enforces a mandatory human review gate so nothing is ever posted autonomously. ## Core Features & Use Cases - Community Scanning: Finds unanswered open issues and discussions from the last 7 days using GitHub MCP tools or the gh CLI, filtering out internal or wontfix items. - Template-Based Drafting: Classifies each thread into one of nine response types (welcome, troubleshooting, feature guidance, redirect, acknowledgment, closing, technical uncertainty, empathetic disagreement, information request) and drafts from the matching template. - Confidence & Risk Gating: Assigns green/yellow/red confidence levels with auto-escalation rules for competitor mentions, pricing questions, and frustrated authors. - Human Review Gate & Audit: Presents drafts in a review table, waits for explicit approval commands, supports a 'banana' safe-word freeze, and logs every action to an audit trail. - Use Case: A maintainer says "PAO, check community" each morning; the Skill scans the repo, drafts three responses with full thread summaries, and the maintainer approves two and edits one before posting. ## Quick Start Ask the agent to check the community by saying "PAO, check community" and it will scan open GitHub issues and discussions, then present drafted responses for your review.

Frequently Asked Questions about external-comms

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

FAQPage Schema
How do I draft GitHub issue responses with human review?

Trigger the workflow with "PAO, check community" to scan open issues and discussions, then review the presented draft table. Approve drafts with commands like "pao approve 1 3", edit with "pao edit 2", or skip all; nothing posts without explicit approval.

How do I find unanswered GitHub issues and discussions?

The scan uses GitHub MCP tools or gh CLI commands like "gh issue list --state open" and the discussions API filtered to unanswered items. It limits results to the last 7 days and excludes items labeled squad:internal or wontfix.

Can this workflow post replies automatically without approval?

No. Phase 1 is draft-only mode with a mandatory human review gate; the agent never posts autonomously. A human posts approved drafts via gh issue comment or the discussions API, and every action is recorded in the audit log.

Does it support GitHub Discussions as well as issues?

Yes, it scans both issues and discussions in the same sweep using the GitHub Discussions API. For Q&A discussions it drafts an answer rather than a comment, and Phase 1 scope explicitly excludes pull request replies.

What happens if a posted community response is wrong?

The rollback procedure deletes the comment via the GitHub API, logs the deletion with a reason in the audit trail, and drafts a corrected replacement through the normal review cycle. A postmortem step updates templates or anti-patterns if the error reveals a gap.