ln-914-community-responder

Paths: File paths (references/, ../ln-*) are relative to this skill directory.

ln-914-community-responder

Type: L3 Worker (standalone) Category: 9XX Community Engagement Responds to unanswered GitHub Discussions and Issues by analyzing the question, searching the codebase for answers, and composing a helpful reply. Supports single-item and batch modes.

---

Overview

Aspect	Details
Input	$ARGUMENTS: discussion/issue number (#42), batch (all unanswered P1), or empty (interactive)
Output	Response comment(s) published to GitHub
Pattern	Read question → Search codebase → Compose response → Fact-check → Publish

---

Phase 0: GitHub Discovery

MANDATORY READ: Load references/community_github_discovery.md

Execute the discovery protocol. Extract:

• {owner}/{repo} for URLs and API calls
• repo.id for GraphQL mutations
• maintainer login (authenticated user)
• Discussion category IDs

Load strategy: check docs/community_engagement_strategy.md in target project, fallback to references/community_strategy_template.md. Extract Section 5 (Engagement Metrics) and Section 6 (Tone Guide).

MANDATORY READ: Load references/community_discussion_formatting.md MANDATORY READ: Load response_styles.md MANDATORY READ: Load references/humanizer_checklist.md

---

Phase 1: Load Items

Single Item Mode

If $ARGUMENTS contains a number (e.g., 42, #42):

# For discussions
gh api graphql -f query='query($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    discussion(number: {N}) {
      id number title body
      category { name }
      author { login }
      createdAt
      answerChosenAt
      comments(first: 20) {
        totalCount
        nodes { author { login } body createdAt }
      }
    }
  }
}' -f owner="{owner}" -f name="{repo}"

# For issues (if discussion not found)
gh issue view {N} --repo {owner}/{repo} --json number,title,body,author,createdAt,comments,labels

Batch Mode

If $ARGUMENTS is batch:

1. Fetch recent discussions + issues via GraphQL (last 30 days, open, sorted by created DESC)
2. Filter to P1 items: author != maintainer AND zero maintainer comments
3. Fetch full context for each item (max 10 per batch)

Interactive Mode

If $ARGUMENTS is empty, list recent unanswered items and ask the user which to respond to.

---

Phase 2: Analyze Context

For each item:

2a. Understand the Question

1. Read the discussion/issue body — identify the core question or problem
2. Read existing comments — check if partially answered or if follow-ups changed the scope
3. Detect item type: Q&A question, bug report, feature request, configuration help, general feedback

2b. Search Codebase for Answer

Based on the question type, search for relevant information:

Question Type	Search Strategy
"How do I..."	Grep for keywords in SKILL.md files, README.md, docs/
Bug report	Grep for mentioned function/file, check git log for recent fixes
Configuration	Read .hex-skills/environment_state.json, CLAUDE.md, relevant SKILL.md
Feature request	Check if feature already exists, grep for related patterns
Installation	Read README.md installation section, plugin.json

FOR each item:
  1. Extract keywords from question (function names, skill names, error messages)
  2. Grep codebase for keywords (max 5 searches)
  3. Read relevant files (max 3 files, prioritize SKILL.md and docs/)
  4. Check git log for recent changes related to the topic
  5. If answer found → proceed to Phase 3
  6. If not found → mark as "needs-manual" and suggest the user respond directly

2c. Detect First-Time Poster

gh api graphql -f query='query($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    discussions(first: 100) {
      nodes { author { login } }
    }
  }
}' -f owner="{owner}" -f name="{repo}"

Count how many discussions the author has created. If 0 previous (this is their first) → flag for Welcome style.

---

Phase 3: Classify Response Type

MANDATORY READ: Load response_styles.md — use the classification matrix.

Item Type	Response Style
Q&A question with answer found	Technical Answer
Bug report	Bug Acknowledgment
Feature request / idea	Feature Acknowledgment
Question already answered elsewhere	Redirect
First-time poster (any type)	Welcome + appropriate content style
Stale item with progress update	Status Update
Cannot find answer in codebase	Mark needs-manual — skip composition

---

Phase 4: Compose Response

Use the selected style template from response_styles.md.

Required Elements (All Styles)

• Thank the author — by name if possible, acknowledge their contribution
• Answer the question — direct, clear, linked to source code/docs
• Invite follow-up — "Let us know if this helps" or similar
• No jargon without context — explain internal terms
• Link to code — at least one link to relevant file in the repo

Batch Mode Composition

In batch mode, compose all responses first, then present ALL for user review before publishing any.

---

Phase 5: Fact-Check

Before presenting to user, verify every claim:

1. File paths & links — verify each linked file exists: ls {path}

2. Code references — verify mentioned functions/classes exist: grep -r "{name}"

3. Feature descriptions — re-read source file, confirm accuracy

4. Install/usage commands — verify against README.md

5. Humanizer audit -- run the audit protocol from humanizer_checklist.md. If 3+ AI patterns found, rewrite flagged sections.

Gate: If any check fails, fix the response before proceeding.

---

Phase 6: Review and Publish

Single Item Mode

Present the composed response to the user. Wait for explicit approval before publishing.

Batch Mode

Present ALL responses in a summary table:

### Batch Responses — {N} items

| # | Type | Title | Style | Status |
|---|------|-------|-------|--------|
| {number} | {Discussion/Issue} | {title} | {Technical/Bug/Welcome/...} | Ready |
| {number} | ... | ... | ... | needs-manual |

Then show each response body. User can approve all, approve selectively, or edit individual responses.

Publish Discussion Comment

gh api graphql -f query='
  mutation($discussionId: ID!, $body: String!) {
    addDiscussionComment(input: {
      discussionId: $discussionId,
      body: $body
    }) {
      comment { url }
    }
  }
' -f discussionId="{discussion.id}" -f body="{response body}"

Publish Issue Comment

gh issue comment {number} --repo {owner}/{repo} --body "{response body}"

Report the comment URL(s) to the user.

---

Rules

• Always require user approval before publishing any response
• Never close discussions or issues — only respond
• Never mark as answered — let the author do it (for Q&A discussions)
• Batch limit: max 10 items per batch (prevent context overload)
• needs-manual items: report to user with GitHub URL + reason, do not attempt response
• Tone: per strategy Section 6 — respectful, helpful, link to code

---

Definition of Done

• Items loaded (single, batch, or interactive selection)
• Question context analyzed + codebase searched for answers
• Response type classified per response_styles.md
• First-time posters detected and welcomed
• Response(s) composed with links to relevant code/docs
• Fact-checked (file paths, code references, commands verified)
• User approved response(s)
• Published via GraphQL/CLI, comment URL(s) reported
• needs-manual items reported to user with URLs

---

Version: 1.0.0 Last Updated: 2026-03-14