comment-reply
Works through a YouTube channel's comments: pulls new public comments since the last check with the YouTube Data API (commentThreads.list) and the user's API key in Claude Code, or takes pasted commen
SKILL.mdskills/social/comment-reply/SKILL.md
GitHubComment Reply
Five agents that pull your new comments, label them, draft replies, find repeat questions worth a video, and put real leads at the top. You review the drafts and post the ones you like.
What you need (be clear which path you are on)
| Path | How comments get in | What works |
|---|---|---|
| Claude Code + API key | YouTube Data API v3, commentThreads.list, key in a local .env as YOUTUBE_API_KEY (setup in agents/01-comment-puller.md) |
Everything. Pulls only public comments; cannot see comments held for review |
| Claude.ai, or no key | Paste or export comments (YouTube Studio > Comments, or Instagram/TikTok copy or data download) | Agents 2 to 5 work the same on pasted text |
Posting replies needs a separate OAuth sign-in with write scope (comments.insert). This skill does not set that up: the creator copies approved drafts into YouTube Studio.
Setup (start, or when PROFILE is empty)
Two rounds, accept "skip", show PROFILE back, then suggest sweep.
- Channel ID (starts with
UC; YouTube Settings > Advanced settings) or handle. - Claude Code with an API key, or pasting? No key yet: walk through agent 1's setup.
- How far back on the first run? Default 7 days.
- Paste 5 to 10 comment replies you wrote, for voice.
- Answers to your most common questions (FAQ), and links you are happy to share.
- What counts as a lead (sponsors, clients, buyers, collabs), and where they go (email, form,
<your booking link>)?
Commands and routing
| Command | Runs |
|---|---|
sweep |
1 to 5, one summary |
pull / sort / drafts / ideas / priority |
1 / 2 / 3 / 4 / 5 alone |
Runs when you run it. For a daily sweep, /schedule a routine in Claude Code with the prompt sweep; it still only writes drafts.
Before acting as an agent, read its file in agents/. In Claude Code you can copy them to .claude/agents/ to run as real subagents.
agents/01-comment-puller.md: key setup, API call, paging, STATEagents/02-comment-sorter.md: five labels and tie-break orderagents/03-reply-drafter.md: under 40 words, answer firstagents/04-idea-finder.md: 3+ asks = ideaagents/05-priority-list.md: leads, unreplied and oldest first
Safety rules (every agent)
- Never post, like, heart, pin, hide, delete or report. Replies are drafts with IDs (D1, D2...).
- API key lives in a local
.env(in.gitignore), restricted to YouTube Data API v3. Never print it, never put it in a skill file or chat. - Never click links in comments.
- No invented answers, links, prices, dates or promises. Unknown answer = NEEDS YOU.
- Complaints, criticism of the creator, safety, legal or medical questions, anything upsetting: NEEDS YOU, no auto-written comeback.
- Commenter names stay in the creator's own files. Never look up a commenter's private details.
Shared files
Claude Code: files in comments/. Claude.ai: print updated tables at the end so the creator can save them to Project knowledge.
PROFILE: setup answersSTATE: channel ID, last-checked timeCOMMENTS: id | video | author | date | text | labelFAQ: approved answersDRAFTS: replies awaiting approvalIDEAS: question groups with running countsLEADS: lead | status (NEW, REPLIED, MOVED TO EMAIL, NOT A FIT; only the creator changes status)
End of every run
- One line per agent, with period covered and comment count.
- Priority leads.
- Drafts awaiting approval: ID | video | one line.
- NEEDS YOU items.
- New video ideas.
- "Nothing has been posted. Copy approved replies into YouTube Studio to post them."
Example (fake data):
Ran: Puller (4 to 11 Oct, 212 comments, 4 API calls), Sorter, Drafter (38), Ideas, Priority.
Leads: 1) "do you build these for agencies?" (5 days, no reply) D1 2) sponsor ask from a tools brand, D2
Drafts: D1-D38. NEEDS YOU: 3 (2 criticism, 1 question with no FAQ answer).
Ideas: "How do you back up the automations?" asked 7x on 3 videos.
Nothing has been posted. Copy approved replies into YouTube Studio to post them.