---
name: discussion-commenter
description: Post Q&A entries from markdown writeups as comments to a GitHub Discussion. Use when the user wants to post writeup content to a discussion thread.
---

# Discussion Commenter

Post Q&A entries from markdown writeups as individual comments to a GitHub Discussion.

## Usage

Run the script with the writeup file path, discussion URL, and date:

```bash
uv run .agents/skills/discussion-commenter/post_qas.py \
  "path/to/writeup.md" \
  "https://github.com/orgs/ORG/discussions/NUMBER" \
  "2026/01/06"
```

## Arguments

1. `writeup_path` - Path to the markdown writeup file containing Q&As
2. `discussion_url` - Full URL to the GitHub discussion
3. `date` - Date string to prefix each comment (e.g., "2026/01/06")

## Options

- `--dry-run` - Parse and display what would be posted without actually posting

## Requirements

- GitHub CLI (`gh`) must be installed and authenticated
- User must have permission to comment on the discussion

## Output

Each `## Question` section in the writeup becomes a separate comment, formatted as:

```markdown
**2026/01/06: Question Title**

Answer content...
```

Subsections (`### Follow-up`) are included in the parent question's comment.