@opendirectory.dev/skills 0.1.34 → 0.1.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendirectory.dev/skills",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/registry.json

@@ -77,6 +77,16 @@
     "version": "1.0.0",
     "path": "skills/explain-this-pr"
   },
+  {
+    "name": "gh-issue-to-demand-signal",
+    "description": "Takes a competitor's public GitHub repo URL, fetches their open issues via the GitHub REST API, filters noise locally, clusters issues into 6 deman...",
+    "tags": [
+      "Developer Tools"
+    ],
+    "author": "opendirectory",
+    "version": "0.0.1",
+    "path": "skills/gh-issue-to-demand-signal"
+  },
   {
     "name": "google-trends-api-skills",
     "description": "SEO keyword research workflow for blog generation using Google Trends data.",
@@ -177,6 +187,16 @@
     "version": "1.0.0",
     "path": "skills/noise2blog"
   },
+  {
+    "name": "npm-downloads-to-leads",
+    "description": "Takes a list of npm package names (yours or competitors'), fetches 12 weeks of daily download data from the npm API, computes a breakout velocity s...",
+    "tags": [
+      "Branding"
+    ],
+    "author": "opendirectory",
+    "version": "0.0.1",
+    "path": "skills/npm-downloads-to-leads"
+  },
   {
     "name": "outreach-sequence-builder",
     "description": "Takes a buying signal and generates a personalized multi-channel outreach sequence across email, LinkedIn, and phone.",

package/skills/gh-issue-to-demand-signal/.env.example

@@ -0,0 +1,3 @@
+GITHUB_TOKEN=      # optional -- github.com/settings/tokens (no scopes needed for public repos)
+                   # Without it: 60 req/hr unauthenticated (enough for ~2 fetches before hitting limit)
+                   # With it: 5000 req/hr (effectively unlimited for this skill's 2-page fetch pattern)

package/skills/gh-issue-to-demand-signal/README.md

@@ -0,0 +1,118 @@
+# gh-issue-to-demand-signal
+
+Give the skill a competitor's public GitHub repo URL. It fetches their open issues, filters noise locally, clusters into 6 demand categories using the AI already running the skill, scores by real engagement (reactions), detects ignored demand (high reactions + no response = your opportunity), and outputs a ranked demand gap report with a GTM messaging brief.
+
+## Install
+
+```bash
+npx "@opendirectory.dev/skills" install gh-issue-to-demand-signal --target claude
+```
+
+### Video Tutorial
+Watch this quick video to see how it's done:
+
+https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
+
+### Step 1: Download the skill from GitHub
+1. Click the **Code** button on this repo's GitHub page.
+2. Select **Download ZIP** to download the repository.
+3. Extract the ZIP file on your computer.
+
+### Step 2: Install the Skill in Claude
+1. Open your **Claude desktop app**.
+2. Go to the sidebar on the left side and click on the **Customize** section.
+3. Click on the **Skills** tab, then click on the **+** (plus) icon button to create a new skill.
+4. Choose the option to **Upload a skill**, and drag and drop the `.zip` file (or you can extract it and drop the folder, both work).
+
+> **Note:** For some skills (like `position-me`), the `SKILL.md` file might be located inside a subfolder. Always make sure you are uploading the specific folder that contains the `SKILL.md` file!
+
+## What It Does
+
+- Fetches up to 200 open issues from any public GitHub repo (no auth required)
+- Filters noise locally: removes PRs, bot issues, zero-engagement issues, and chore-pattern titles
+- Computes a demand score per issue: `(reactions["+1"] x 2) + (comments x 0.5)`
+- Detects "ignored demand": issues with 10+ reactions, open 6+ months, no planned label
+- Clusters issues into 6 categories using the AI running the skill (no external API key needed): feature gaps, bug patterns, UX complaints, performance issues, missing integrations, missing docs
+- Generates 5-8 cluster themes with total demand scores
+- Messaging brief: 3 positioning angles + 3 outreach hooks + cluster-specific headlines
+- Saves output to `docs/demand-signals/[owner]-[repo]-[date].md`
+
+## Requirements
+
+| Requirement | Purpose | How to Set Up |
+|---|---|---|
+| GitHub token | Raises rate limit from 60/hr to 5000/hr | github.com/settings/tokens (no scopes needed for public repos) |
+
+No external AI API key needed. The skill uses the AI assistant running it (Claude, Gemini, Copilot) to do the clustering and messaging brief. GitHub token is optional but recommended for repeated use.
+
+## Setup
+
+```bash
+cp .env.example .env
+# Add GITHUB_TOKEN (optional, recommended for repeated use)
+```
+
+## How to Use
+
+```
+"Scan competitor GitHub issues: https://github.com/vercel/next.js"
+"What are users asking for in facebook/react?"
+"Find demand gaps in linear-app/linear"
+"Turn GitHub complaints into messaging: https://github.com/supabase/supabase"
+"What should I build based on competitor issues? vercel/next.js"
+"Which features are users begging for in this repo?"
+```
+
+## Why This Matters
+
+A busy product team cannot read 500 open issues. This skill does the work: ranks by real user demand (reaction counts), clusters into actionable GTM categories, detects ignored demand (where competitors have been silent the longest), and translates raw complaints into positioning language.
+
+**The demand score formula:** `(reactions["+1"] x 2) + (comments x 0.5)`. Reactions are weighted higher than comments because reactions are pure signal -- a thumbs-up means "I want this." Comments include maintainer responses, off-topic discussion, and spam.
+
+**Ignored demand is your opportunity:** An issue with 50 reactions that has been open for 2 years with no planned label means their users have been waiting. That is your product's first billboard.
+
+## The 6 Demand Categories
+
+| Category | What it captures |
+|---|---|
+| `feature_gap` | Functionality that does not exist yet |
+| `bug_pattern` | Recurring broken behavior that erodes trust |
+| `ux_complaint` | Friction, confusion, or workflow problems |
+| `performance` | Slowness, timeouts, resource usage |
+| `integration_missing` | Requests to connect with other tools or APIs |
+| `docs_missing` | Confusion caused by absent or wrong documentation |
+
+## Output
+
+Each run produces:
+
+1. **Demand Gap Leaderboard**: clusters ranked by total demand score
+2. **Ignored Demand section**: issues open 6+ months with 10+ reactions and no response
+3. **Top 10 Highest-Demand Issues**: verbatim titles, reaction counts, direct GitHub links
+4. **Cluster Deep Dives**: top 3 clusters with theme name, pain summary, top 3 verbatim issues
+5. **Messaging Brief**: 3 positioning angles citing exact demand evidence
+6. **GTM Angles**: 3 outreach hooks using verbatim issue language
+
+## Cost per Run
+
+- GitHub API: 2 calls -- free (unauthenticated: 60/hr limit, token: 5000/hr)
+- AI analysis: uses the model already running the skill -- no additional cost
+- Total: free
+
+## Project Structure
+
+```
+gh-issue-to-demand-signal/
+├── SKILL.md
+├── README.md
+├── .env.example
+├── evals/
+│   └── evals.json
+└── references/
+    ├── demand-categories.md
+    └── gtm-translation.md
+```
+
+## License
+
+MIT