@opendirectory.dev/skills 0.1.64 → 0.1.65

package/skills/reddit-icp-monitor/README.md

@@ -14,7 +14,7 @@ npx "@opendirectory.dev/skills" install reddit-icp-monitor --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
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 
 ### Step 1: Download the skill from GitHub
 1. Copy the URL of this specific skill folder from your browser's address bar.
@@ -28,114 +28,3 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
 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
-
-- Reads your ICP definition from docs/icp.md (or asks 3 questions to build it)
-- Searches specified subreddits for posts matching your pain point phrases
-- Scores each candidate post 1-5 using Gemini (how clearly does this person have the problem you solve?)
-- Drafts a helpful reply for every post scoring 4 or 5, in the correct mode (vent, how-do-you, or tool recommendation)
-- Enforces a hard rule: replies never name your product unless the post explicitly asks for tool recommendations
-- Saves the full report to docs/reddit-intel/YYYY-MM-DD.md
-
-## Requirements
-
-| Requirement | Purpose | How to Set Up |
-|------------|---------|--------------|
-| Gemini API key | Relevance scoring and reply drafting | aistudio.google.com, Get API key |
-| Reddit credentials (optional) | Higher rate limit (60 RPM vs 10 RPM) | reddit.com/prefs/apps, create a script app |
-
-Reddit credentials are optional. The skill uses Reddit's public JSON endpoints by default, which require no setup and support 10 RPM. That is enough for most monitoring sessions.
-
-## Setup
-
-```bash
-cp .env.example .env
-```
-
-Fill in:
-- `GEMINI_API_KEY` (required)
-- Reddit credentials (optional, see OAuth Upgrade below)
-
-## How to Use
-
-First run (no docs/icp.md yet):
-```
-"Monitor Reddit for my ICP signals"
-"Scan subreddits for people who need my product"
-```
-
-The skill asks 3 questions to build your ICP definition and saves it to docs/icp.md.
-
-Subsequent runs (docs/icp.md exists):
-```
-"Check Reddit for buying signals"
-"Run the Reddit ICP monitor for this week"
-"Find ICP posts from the last month"
-```
-
-Specify a time window:
-```
-"Monitor Reddit for ICP signals from the last 24 hours"
-"Check Reddit for this month's pain point posts"
-```
-
-## Output
-
-Each run produces a report with:
-- All subreddits monitored and time window
-- Each high-signal post: title, URL, upvotes, signal quote, matched keyword, post type
-- A drafted reply for each match (2-5 sentences, mode-appropriate)
-- A list of subreddits that returned 0 results (for tuning)
-
-Reports are saved to `docs/reddit-intel/YYYY-MM-DD.md`.
-
-## Reply Modes
-
-The skill classifies each post and drafts in the appropriate mode:
-
-| Mode | Post Type | Can Name Product? |
-|------|-----------|------------------|
-| Mode 1 | Venting / frustration | Never |
-| Mode 2 | "How do you handle X?" | Never |
-| Mode 3 | "What tool does X?" | Yes, with one alternative |
-
-## Choosing Good Subreddits
-
-**Where to monitor (people describing problems):**
-- r/devops, r/ExperiencedDevs, r/sysadmin: engineers asking operational questions
-- r/startups, r/SaaS, r/EntrepreneurRideAlong: founders and operators venting about scaling
-- r/sales, r/marketing: GTM practitioners asking how others handle things
-
-**Where not to monitor:**
-- Topic subreddits (r/programming, r/MachineLearning): discussions, not pain points
-- Your product's own subreddit: not monitoring your own community
-- Broad consumer subreddits: not your B2B ICP
-
-## OAuth Upgrade
-
-If you need more than 10 RPM (large subreddits or frequent runs):
-
-1. Go to reddit.com/prefs/apps and create a "script" app
-2. Note: app approval may take several days as of late 2025
-3. Fill in REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD in .env
-
-With OAuth, the skill fetches a Bearer token at session start and uses the `oauth.reddit.com` endpoint for 60 RPM.
-
-## Project Structure
-
-```
-reddit-icp-monitor/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── evals/
-│   └── evals.json
-└── references/
-    ├── icp-format.md
-    └── reply-rules.md
-```
-
-## License
-
-MIT

package/skills/reddit-post-engine/README.md

@@ -14,7 +14,7 @@ npx "@opendirectory.dev/skills" install reddit-post-engine --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
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 
 ### Step 1: Download the skill from GitHub
 1. Copy the URL of this specific skill folder from your browser's address bar.
@@ -28,100 +28,3 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
 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 the target subreddit's rules and top posts from Reddit's public API
-- Identifies the subreddit's tone and posting conventions
-- Drafts a title and body that match the community's style
-- Keeps product links out of the body (puts them in the first comment)
-- Optionally posts directly via Composio
-- Covers 7 common subreddits with specific playbooks
-
-## Requirements
-
-| Requirement | Purpose | How to Set Up |
-|------------|---------|--------------|
-| Gemini API key | Post drafting and tone matching | aistudio.google.com, Get API key |
-| Composio Reddit MCP (optional) | Direct posting | app.composio.dev |
-
-## Setup
-
-### 1. Configure environment variables
-
-```bash
-cp .env.example .env
-# Add GEMINI_API_KEY (required)
-# Add COMPOSIO_API_KEY if you want direct posting
-```
-
-### 2. Connect Reddit via Composio (optional)
-
-Direct posting requires a Composio account connected to Reddit OAuth:
-
-1. Get your Composio API key at app.composio.dev/settings
-2. Connect Reddit at app.composio.dev/app/reddit
-3. Add the MCP server to Claude Code:
-
-```bash
-claude mcp add --transport http reddit-composio \
-  "https://mcp.composio.dev/reddit/YOUR_COMPOSIO_API_KEY"
-```
-
-4. Verify: `claude mcp list` should show `reddit-composio`
-
-Without Composio, the skill drafts posts for manual copy-paste submission.
-
-## How to Use
-
-Draft a post for a specific subreddit:
-```
-"Help me post my project on r/SideProject"
-"Write a Reddit post for r/devops about my Kubernetes tool"
-"Draft something for r/startups: we hit $1k MRR"
-```
-
-With direct posting:
-```
-"Post my project to r/SideProject via Composio"
-```
-
-Multi-subreddit drafts:
-```
-"Draft posts for r/SideProject and r/indiehackers for my launch"
-```
-
-## Subreddit Playbook Summary
-
-| Subreddit | Tone | What Works |
-|-----------|------|------------|
-| r/devops | Technical, direct | Problem + solution + specific numbers |
-| r/SideProject | Personal, builder | Build story + honest state + link in comment |
-| r/startups | Business-focused | Lessons learned + metrics |
-| r/programming | Technical, skeptical | Novel approach + code examples |
-| r/ExperiencedDevs | Senior-level | Nuanced tradeoffs, no hand-holding |
-| r/indiehackers | Transparent | Revenue numbers, real story |
-| r/webdev | Friendly | What you built + how it works |
-
-## The 90/10 Rule
-
-Reddit detects promotional patterns. For your posts to land well, 90% of your Reddit activity should be genuine community contribution: answering questions, discussing topics, sharing interesting links. At most 10% should be posts about your own work.
-
-This skill drafts high-quality posts, but the underlying account reputation matters. New accounts with no history posting self-promotional content often get filtered.
-
-## Project Structure
-
-```
-reddit-post-engine/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── evals/
-│   └── evals.json
-└── references/
-    └── subreddit-playbook.md
-```
-
-## License
-
-MIT

package/skills/schema-markup-generator/README.md

@@ -14,7 +14,7 @@ npx "@opendirectory.dev/skills" install schema-markup-generator --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
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 
 ### Step 1: Download the skill from GitHub
 1. Copy the URL of this specific skill folder from your browser's address bar.
@@ -28,111 +28,3 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
 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!
-
-## Schema Types Supported
-
-| Type | Use When |
-|------|----------|
-| FAQPage | Page has 2 or more visible question/answer pairs |
-| Article / BlogPosting | Page is a blog post or editorial article |
-| Organization | Page represents a company or institution |
-| Product | Page sells or describes a product with pricing |
-| WebSite | Homepage schema with optional sitelinks search |
-| HowTo | Page is a step-by-step guide with numbered steps |
-| BreadcrumbList | Page has visible breadcrumb navigation |
-| SoftwareApplication | Page describes a software tool or app |
-| LocalBusiness | Page represents a physical business location |
-
-The agent detects the right type automatically. A single page often gets multiple types (a blog post gets Article and BreadcrumbList, a homepage gets WebSite and Organization).
-
-## Requirements
-
-No LLM API key needed. The agent reads the page and generates the markup.
-
-Chrome is needed for JavaScript-rendered pages. For static HTML pages or when you paste HTML directly, Chrome is not required.
-
-A GitHub token is optional. Without it, the agent outputs the markup as text for you to paste manually.
-
-## Setup
-
-### 1. Start Chrome with remote debugging (for live URLs)
-
-```bash
-# macOS
-open -a "Google Chrome" --args --remote-debugging-port=9222
-
-# Linux
-google-chrome --remote-debugging-port=9222
-```
-
-### 2. Configure environment variables (optional)
-
-```bash
-cp .env.example .env
-# Add GITHUB_TOKEN if you want auto-PR support
-```
-
-## How to Use
-
-From a live URL:
-
-```
-"Generate schema markup for https://example.com/faq"
-"Add structured data to https://example.com/blog/my-post"
-"What schema markup does this page need? https://example.com/about"
-```
-
-From pasted HTML:
-
-```
-"Generate schema markup for this page: [paste HTML]"
-"Add JSON-LD to this HTML: [paste HTML]"
-```
-
-Targeting a specific type:
-
-```
-"Generate FAQPage schema for https://example.com/support"
-"Add Organization schema to our about page: https://example.com/about"
-"Generate Product schema for this page: https://example.com/products/pro"
-```
-
-With auto-PR:
-
-```
-"Generate schema markup for https://example.com/blog/post and open a GitHub PR"
-```
-
-## Output
-
-| Output | Description |
-|--------|-------------|
-| JSON-LD script block | One `<script type="application/ld+json">` block per schema type |
-| Placement instructions | Where to insert the block in your HTML or framework |
-| MISSING field list | Required fields not found on the page that you need to fill in |
-| GitHub PR | If GITHUB_TOKEN and GITHUB_REPO are configured and you confirm |
-
-## Validate Your Markup
-
-After applying the markup, validate it at:
-
-- Google Rich Results Test: https://search.google.com/test/rich-results
-- Schema.org Validator: https://validator.schema.org
-
-## Project Structure
-
-```
-schema-markup-generator/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── evals/
-│   └── evals.json
-└── references/
-    ├── json-ld-spec.md
-    └── output-template.md
-```
-
-## License
-
-MIT

package/skills/sdk-adoption-tracker/README.md

@@ -11,7 +11,7 @@ npx "@opendirectory.dev/skills" install sdk-adoption-tracker --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
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 
 ### Step 1: Download the skill from GitHub
 1. Copy the URL of this specific skill folder from your browser's address bar.
@@ -25,129 +25,3 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
 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!
-
-Note: Upload the folder that contains the `SKILL.md` file.
-
-## What It Does
-
-- Searches GitHub code for all public repos that import or require the SDK
-- Supports npm, Python, Go, Ruby, and generic import patterns -- auto-detected from the SDK name
-- Filters forks, tutorials, examples, and archived repos from results
-- Classifies each repo: company org, affiliated developer, solo developer, or tutorial noise
-- Scores by adoption signal: org type, company field, stars, recency, fork status
-- Fetches owner profile and top contributor for each high-signal repo
-- Tracks adoption velocity: new repos in last 7, 14, and 30 days
-- Compares to previous snapshot for exact new-adopter count on repeat runs
-- Generates an outreach brief per high-signal company repo: what they are building, who introduced the SDK, and what to say
-- Saves output to `docs/sdk-adopters/[sdk-name]-[date].md`
-
-## Requirements
-
-| Requirement | Purpose | How to Set Up |
-|---|---|---|
-| GitHub token | Required for code search (unauthenticated limit is 3 req/min, too low to run) | github.com/settings/tokens (no scopes needed for public repos) |
-
-## Setup
-
-```bash
-cp .env.example .env
-# Add GITHUB_TOKEN
-```
-
-## How to Use
-
-```
-"Who is using my SDK on GitHub? @company/my-sdk"
-"Find companies building on my library: stripe"
-"Track adoption of my Python package: requests"
-"Which orgs import my SDK: @clerk/nextjs"
-"Show me who uses my library and rank by company signal"
-"Find warm leads from SDK adopters: my-package"
-```
-
-Include a short description of your product and the skill will tailor the outreach message to your context.
-
-## Why Score Instead of Just List
-
-A raw GitHub code search for a popular SDK returns tutorials, forks, abandoned side projects, and examples mixed in with real production users. The adoption score separates them:
-
-- A company org repo with recent commits and 200 stars scores 130+
-- A tutorial named "learn-stripe-payments" scores below 20 and is excluded
-
-The person who added the import in a company repo is the warmest possible lead. They chose the SDK, they understand what it does, and they have an active production use case.
-
-## The Adoption Score
-
-`score = org_signal + company_field + stars_capped + recency + quality_flags`
-
-- Org type (50 points): GitHub Organization accounts are almost always a company or serious team
-- Company field (20 points): user has a company listed on their GitHub profile
-- Stars (up to 50 points): capped at 500 stars to prevent established open-source from dominating
-- Recency (up to 50 points): pushed in last 7 or 30 days
-- Quality (up to 40 points): not a fork, not archived, not a tutorial
-
-Score >= 80: full outreach brief generated. Score 40-79: listed in report. Score < 40: counted in breakdown only.
-
-## Velocity Tracking
-
-Run the skill weekly and save the JSON snapshot. On each subsequent run, the skill compares the current repo list to the previous snapshot and tells you exactly how many new teams adopted the SDK since last time.
-
-```
-New repos last 7 days: 3
-New repos last 30 days: 11
-New since last run (7 days ago): 3
-```
-
-## Cost Per Run
-
-- GitHub Code Search API: free with token
-- GitHub User, Org, Contributors API: free with token
-- AI analysis: uses the model already running the skill; no additional cost
-- Total: free
-
-## Standalone Script
-
-Run the data-fetching step directly from the terminal without Claude. Useful for scheduled jobs or CI pipelines.
-
-```bash
-# Basic usage
-python3 scripts/fetch.py stripe
-
-# Python SDK
-python3 scripts/fetch.py requests --ecosystem python
-
-# With product context for outreach
-python3 scripts/fetch.py @company/my-sdk --context "We build observability for DevTools"
-
-# Exclude the SDK publisher's own repos
-python3 scripts/fetch.py stripe --exclude stripe
-
-# Print to stdout
-python3 scripts/fetch.py stripe --stdout | jq '.summary'
-```
-
-The script handles Steps 3-5 (code search, scoring, enrichment) and writes a JSON file. Open that file with Claude and ask: "Generate adoption briefs from this SDK data."
-
-```bash
-GITHUB_TOKEN=your_token python3 scripts/fetch.py stripe --output results.json
-```
-
-## Project Structure
-
-```
-sdk-adoption-tracker/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── scripts/
-│   └── fetch.py           standalone fetcher (Steps 3-5, no Claude needed)
-├── evals/
-│   └── evals.json
-└── references/
-    ├── import-patterns.md
-    └── scoring-guide.md
-```
-
-## License
-
-MIT

package/skills/show-hn-writer/README.md

@@ -14,7 +14,7 @@ npx "@opendirectory.dev/skills" install show-hn-writer --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
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 
 ### Step 1: Download the skill from GitHub
 1. Copy the URL of this specific skill folder from your browser's address bar.
@@ -28,85 +28,3 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
 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
-
-- Reads your project context (from README or your answers)
-- Drafts three Show HN title variants in different formats
-- Writes a 150-350 word body following HN community norms
-- Uses Gemini to flag marketing language, vague descriptions, or other HN anti-patterns
-- Runs a self-QA checklist before presenting output
-- Includes submission notes (timing, first-comment strategy, resubmission rules)
-
-## Requirements
-
-| Requirement | Purpose | How to Set Up |
-|------------|---------|--------------|
-| Gemini API key (optional) | Automated draft review for HN anti-patterns | aistudio.google.com, Get API key |
-
-The skill works without Gemini: it runs the manual self-QA checklist instead.
-
-## Setup
-
-```bash
-cp .env.example .env
-# Add GEMINI_API_KEY if you want automated review (optional)
-```
-
-## How to Use
-
-From a README:
-```
-"Write a Show HN post for my project"
-"Help me launch on Hacker News"
-"Draft a Show HN for the project in this repo"
-```
-
-With explicit context:
-```
-"Write a Show HN post for [project name]: [what it does]. I built it because [reason]."
-```
-
-For a specific title format:
-```
-"Write a Show HN title for my CLI tool that converts JSON to TypeScript interfaces"
-```
-
-## Show HN Title Formats
-
-| Format | Example | Best For |
-|--------|---------|----------|
-| Product-First | `Show HN: Datasette – Instantly publish SQLite databases to the web` | Single-function tools |
-| Outcome-Focused | `Show HN: Jitsi – Group video calls without an account` | Tools replacing something painful |
-| Technical-Angle | `Show HN: Bun – JavaScript runtime built in Zig` | Dev tools where the implementation matters |
-| Experiment | `Show HN: Ink – React for command-line apps` | Projects challenging a convention |
-
-## What Makes a Good Show HN Post
-
-**Title:** 60-80 characters. Starts with "Show HN:". En dash separator. No adjectives.
-
-**Body:** First-person. 150-350 words. At least one technical detail. Honest about limitations. Ends with an invitation for feedback, not a CTA.
-
-**What kills HN posts:**
-- Vague titles ("Show HN: I built a thing for developers")
-- Marketing adjectives ("fast", "simple", "powerful")
-- Asking for upvotes
-- Body that reads like a product page
-
-## Project Structure
-
-```
-show-hn-writer/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── evals/
-│   └── evals.json
-└── references/
-    ├── hn-rules.md
-    └── title-formulas.md
-```
-
-## License
-
-MIT

package/skills/stargazer/README.md

@@ -77,3 +77,24 @@ Generate a final CSV file for use in other applications.
 ```bash
 python stargazer-skill/scripts/convert_to_csv.py
 ```
+
+
+## Install
+
+### Video Tutorial
+Watch this quick video to see how it's done:
+
+https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
+
+### Step 1: Download the skill from GitHub
+1. Copy the URL of this specific skill folder from your browser's address bar.
+2. Go to [download-directory.github.io](https://download-directory.github.io/).
+3. Paste the URL and click **Enter** to download.
+
+### 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!