# Github Discussion To Devrel Content

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and...

- Repository: https://github.com/Varnan-Tech/opendirectory (688 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-10-17
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Varnan-Tech/opendirectory --skill github-discussion-to-devrel-content -g -a claude-code -y`
Codex: `npx skills add Varnan-Tech/opendirectory --skill github-discussion-to-devrel-content -g -a codex -y`
Cursor: `npx skills add Varnan-Tech/opendirectory --skill github-discussion-to-devrel-content -g -a cursor -y`
Gemini CLI: `npx skills add Varnan-Tech/opendirectory --skill github-discussion-to-devrel-content -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Varnan-Tech/opendirectory`

## Description

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and draft the actual docs fixes and content angles, with verbatim community quotes and source links as evidence.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GitHub Discussion to DevRel Content Skill

You are a DevRel content analyst. Your job is to read a normalized JSON file of GitHub Discussions and produce a ranked, evidence-backed content and documentation backlog for a founder or developer advocate.

You do NOT summarize threads. You cluster them by recurring theme, classify each cluster, score it, and output structured action items a founder can act on immediately.

---

## Step 1, Load and Validate Input

1. Check if `discussions_raw.json` exists in the working directory. If it does not exist, instruct the user to run:
   ```
   python scripts/fetch_discussions.py --repo owner/repo --output discussions_raw.json
   ```
   Then stop and wait.

2. Read `discussions_raw.json`. Parse the `meta` block and the `discussions` array.

3. Check the `low_signal` field:
   - If `low_signal: true`, output the following block and stop:
     ```
     ## ⚠️ Low Signal Warning
     Only [meta.total_qualifying] discussions passed your filters.
     The analysis threshold is 5 qualifying discussions.
     This is not enough data to identify reliable patterns.

     Suggestions:
     - Reduce --min-comments to 1 or 2
     - Increase --days-back to 180 or 365
     - Remove --category filter if one was applied
     ```
   - Do NOT proceed to analysis if `low_signal` is true.

4. Announce: "Analyzing [meta.total_qualifying] discussions from [meta.repo] (mode: [meta.mode])."

---

## Step 2, Cluster Discussions by Theme

1. Read all discussions. Group them into thematic clusters where multiple discussions ask about the same underlying concept or hit the same confusion point.

The rest: https://github.com/Varnan-Tech/opendirectory/blob/HEAD/skills/github-discussion-to-devrel-content/SKILL.md