@opendirectory.dev/skills 0.1.0

package/skills/luma-attendees-scraper/README.md

@@ -0,0 +1,170 @@
+# Luma Attendees Scraper
+
+<img width="1280" height="640" alt="luma-attendees-scraper-cover" src="https://github.com/user-attachments/assets/44acd3d4-8c4d-4c8a-823b-96cd6585e5ae" />
+
+Browser-console script to export attendee data from a Luma event into CSV.
+
+[luma-attendees-scraper.webm](https://github.com/user-attachments/assets/d324ee4a-8006-44ae-9cee-dca414ef03e9)
+
+## Note
+
+For a test run, set:
+
+```js
+sampleLimit: 5,
+```
+
+This exports a small sample so you can verify the output columns first.
+
+If the sample looks correct, switch to:
+
+```js
+sampleLimit: Infinity,
+```
+
+This exports all available attendees for the event.
+
+The script:
+
+- works from the browser console
+- accepts any Luma event URL
+- fetches the event's internal `event_api_id` automatically
+- exports attendee data from Luma's paginated guest API
+- includes public social handles already present in the guest payload
+
+## Files
+
+- `luma_attendees_export.js`: main browser-console script
+
+## Requirements
+
+- You must be logged into Luma in your browser.
+- Your account must have permission to view the event attendee list.
+- The script should be run on `luma.com` while your authenticated Luma session is active.
+
+If Luma returns `403` with a message like `You don't have access to this event.`, the problem is account access, not the script.
+
+## How To Use
+
+1. Open the target Luma event page in your browser.
+2. Open DevTools Console.
+3. If Chrome blocks paste in the console, type `allow pasting` and press Enter.
+4. Open `luma_attendees_export.js` from this repo.
+5. Edit the `CONFIG` block at the top if needed.
+6. Paste the full script into the browser console and run it.
+7. Wait for the CSV download.
+
+## Recommended Flow
+
+### 1. Verify on a small sample first
+
+Set:
+
+```js
+sampleLimit: 5,
+```
+
+This exports only the first 5 attendees and is the safest way to confirm the output columns look right.
+
+### 2. Run the full export
+
+After the sample looks correct, switch to:
+
+```js
+sampleLimit: Infinity,
+```
+
+This exports the full attendee list.
+
+## Config
+
+The script starts with:
+
+```js
+const CONFIG = {
+  eventUrl: window.location.href,
+  sampleLimit: 5,
+  pageSize: 100,
+  requestDelayMs: 150,
+  apiBase: "https://api2.luma.com",
+  outputFileName: "",
+};
+```
+
+### Config fields
+
+- `eventUrl`: Luma event URL to export. Default is the current page URL.
+- `sampleLimit`: number of attendees to export. Use `5` for testing or `Infinity` for all attendees.
+- `pageSize`: API page size. `100` is a good default.
+- `requestDelayMs`: delay between paginated API requests.
+- `apiBase`: Luma API base URL.
+- `outputFileName`: optional custom CSV filename. Leave empty to auto-generate one.
+
+## CSV Columns
+
+The export includes:
+
+- `Event Name`
+- `Event URL`
+- `Event API ID`
+- `Section`
+- `Name`
+- `First Name`
+- `Last Name`
+- `Bio`
+- `Profile URL`
+- `Username`
+- `API ID`
+- `Instagram`
+- `X`
+- `TikTok`
+- `LinkedIn`
+- `Website`
+- `YouTube`
+- `Avatar URL`
+- `Verified`
+- `Timezone`
+- `Last Online At`
+- `Tickets Registered`
+
+## Why This Works Better Than DOM Scraping
+
+Many Luma event pages no longer render the full attendee list directly in the page DOM. Older console scripts that scrape `a[href^="/user/"]` only capture whatever is currently visible on the page, which may be one attendee or a very small subset.
+
+This script uses the paginated guest API that Luma itself calls when loading attendee data, so it can export the full list when your account has access.
+
+## Data Trust Model
+
+- Attendee rows are exported from Luma's backend guest response.
+- Social fields are read from the guest payload itself when available.
+- The script does not invent people, create fake profiles, or synthesize attendee data.
+- If a field is missing from Luma's response, the CSV cell is left blank.
+
+## Troubleshooting
+
+### `403 You don't have access to this event.`
+
+Your Luma account cannot access that event's guest list. Use an account that can view the attendees.
+
+### CSV downloads but values are blank
+
+This usually means the guest payload shape has changed. Check the `Sample guest:` object printed in the console and update the field mapping.
+
+### Only a few attendees exported
+
+Make sure `sampleLimit` is not still set to a small number like `5`.
+
+### No download starts
+
+Some browsers block downloads from DevTools-triggered scripts until user interaction is allowed. Re-run after enabling downloads for the site.
+
+## Suggested Usage Pattern
+
+1. Run with `sampleLimit: 5`
+2. Inspect the CSV
+3. Switch to `sampleLimit: Infinity`
+4. Run again for the full export
+
+## Disclaimer
+
+Use this responsibly and only for events and attendee lists your account is authorized to access.

package/skills/luma-attendees-scraper/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: luma-attendees-scraper
+description: A skill for luma-attendees-scraper
+author: OpenDirectory
+version: 1.0.0
+---
+

package/skills/luma-attendees-scraper/luma_attendees_export.js

@@ -0,0 +1,223 @@
+(async function () {
+  const CONFIG = {
+    eventUrl: window.location.href,
+    sampleLimit: 5,
+    pageSize: 100,
+    requestDelayMs: 150,
+    apiBase: "https://api2.luma.com",
+    outputFileName: "",
+  };
+
+  const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+  function normalizeHandleUrl(value, baseUrl) {
+    if (!value) return "";
+    if (/^https?:\/\//i.test(value)) return value;
+    if (value.startsWith("/")) return `${baseUrl}${value}`;
+    return `${baseUrl}/${value.replace(/^@/, "")}`;
+  }
+
+  function getProfileUrl(user) {
+    if (!user) return "";
+    if (user.profile_url) return user.profile_url;
+    if (user.user_url) return user.user_url;
+    if (user.url) return user.url;
+    if (user.username) return `https://luma.com/user/${user.username}`;
+    return "";
+  }
+
+  function csvEscape(value) {
+    return `"${String(value ?? "").replace(/"/g, '""')}"`;
+  }
+
+  function slugify(value) {
+    return String(value || "luma-event")
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "")
+      .slice(0, 80);
+  }
+
+  function extractEventApiId(html) {
+    const patterns = [
+      /"event_api_id":"(evt-[^"]+)"/,
+      /"api_id":"(evt-[^"]+)"/,
+      /event_api_id\\":\\"(evt-[^"]+)/,
+      /api_id\\":\\"(evt-[^"]+)/,
+    ];
+
+    for (const pattern of patterns) {
+      const match = html.match(pattern);
+      if (match) return match[1];
+    }
+
+    throw new Error("Could not find event_api_id in the event page HTML.");
+  }
+
+  function extractEventName(html) {
+    const titleMatch = html.match(/<title>(.*?)<\/title>/i);
+    if (titleMatch) {
+      return titleMatch[1]
+        .replace(/\s*[|·-]\s*Luma.*$/i, "")
+        .replace(/\s+/g, " ")
+        .trim();
+    }
+
+    const namePatterns = [
+      /"name":"([^"]+)"/,
+      /"event_name":"([^"]+)"/,
+    ];
+
+    for (const pattern of namePatterns) {
+      const match = html.match(pattern);
+      if (match) return match[1];
+    }
+
+    return "luma-event";
+  }
+
+  async function fetchJson(url) {
+    const response = await fetch(url, {
+      credentials: "include",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+      },
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Request failed (${response.status}): ${text}`);
+    }
+
+    return response.json();
+  }
+
+  async function fetchEventContext(eventUrl) {
+    const response = await fetch(eventUrl, { credentials: "include" });
+    if (!response.ok) {
+      throw new Error(`Failed to load event page (${response.status})`);
+    }
+
+    const html = await response.text();
+    return {
+      eventApiId: extractEventApiId(html),
+      eventName: extractEventName(html),
+      eventUrl,
+    };
+  }
+
+  async function fetchGuests(eventApiId, limit) {
+    const guests = [];
+    let cursor = null;
+
+    while (true) {
+      const url = new URL(`${CONFIG.apiBase}/event/get-guest-list`);
+      url.searchParams.set("event_api_id", eventApiId);
+      url.searchParams.set("pagination_limit", String(CONFIG.pageSize));
+      if (cursor) url.searchParams.set("pagination_cursor", cursor);
+
+      const data = await fetchJson(url.toString());
+      const entries = Array.isArray(data.entries) ? data.entries : [];
+
+      guests.push(...entries);
+      console.log(`Fetched ${guests.length} guests so far`);
+
+      if (guests.length >= limit) {
+        return guests.slice(0, limit);
+      }
+
+      if (!data.has_more || !data.next_cursor) {
+        return guests;
+      }
+
+      cursor = data.next_cursor;
+      await sleep(CONFIG.requestDelayMs);
+    }
+  }
+
+  function buildRows(eventContext, guests) {
+    const rows = [[
+      "Event Name",
+      "Event URL",
+      "Event API ID",
+      "Section",
+      "Name",
+      "First Name",
+      "Last Name",
+      "Bio",
+      "Profile URL",
+      "Username",
+      "API ID",
+      "Instagram",
+      "X",
+      "TikTok",
+      "LinkedIn",
+      "Website",
+      "YouTube",
+      "Avatar URL",
+      "Verified",
+      "Timezone",
+      "Last Online At",
+      "Tickets Registered",
+    ]];
+
+    for (const guest of guests) {
+      const user = guest.user || {};
+
+      rows.push([
+        eventContext.eventName,
+        eventContext.eventUrl,
+        eventContext.eventApiId,
+        guest.section_label || "",
+        user.name || "",
+        user.first_name || "",
+        user.last_name || "",
+        (user.bio_short || "").replace(/\s+/g, " ").trim(),
+        getProfileUrl(user),
+        user.username || "",
+        user.api_id || guest.api_id || "",
+        normalizeHandleUrl(user.instagram_handle, "https://instagram.com"),
+        normalizeHandleUrl(user.twitter_handle, "https://x.com"),
+        normalizeHandleUrl(user.tiktok_handle, "https://www.tiktok.com/@"),
+        normalizeHandleUrl(user.linkedin_handle, "https://www.linkedin.com"),
+        user.website || "",
+        normalizeHandleUrl(user.youtube_handle, "https://www.youtube.com/@"),
+        user.avatar_url || "",
+        user.is_verified ? "true" : "false",
+        user.timezone || "",
+        user.last_online_at || "",
+        guest.num_tickets_registered || 0,
+      ]);
+    }
+
+    return rows;
+  }
+
+  function downloadCsv(rows, fileName) {
+    const csv = rows.map((row) => row.map(csvEscape).join(",")).join("\n");
+    const blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    anchor.download = fileName;
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+    URL.revokeObjectURL(url);
+  }
+
+  const eventContext = await fetchEventContext(CONFIG.eventUrl);
+  const limit = Number.isFinite(CONFIG.sampleLimit) ? CONFIG.sampleLimit : Infinity;
+  const guests = await fetchGuests(eventContext.eventApiId, limit);
+  const rows = buildRows(eventContext, guests);
+  const fileName =
+    CONFIG.outputFileName ||
+    `${slugify(eventContext.eventName)}-${Number.isFinite(limit) ? `sample-${limit}` : "all"}-attendees.csv`;
+
+  console.log("Event context:", eventContext);
+  console.log("Guests exported:", guests.length);
+  console.log("Sample guest:", guests[0] || null);
+
+  downloadCsv(rows, fileName);
+})();

package/skills/meeting-brief-generator/.env.example

@@ -0,0 +1,21 @@
+# meeting-brief-generator — Environment Variables
+# =================================================
+# Tavily and Gemini are required. Notion is optional.
+
+# Required: Tavily API key for company research
+# Get it: app.tavily.com, API Keys section
+TAVILY_API_KEY=your_tavily_api_key_here
+
+# Required: Google Gemini API key for brief synthesis
+# Get it: aistudio.google.com, Get API key
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# Optional: Notion integration token for saving briefs
+# Get it: notion.so/my-integrations, Create new integration, copy Internal Integration Token
+# You must share your target database with this integration in Notion
+NOTION_TOKEN=secret_your_notion_token_here
+
+# Optional: Notion database ID where briefs are saved
+# Get it: open the database in Notion, copy the ID from the URL
+# URL format: notion.so/workspace/{DATABASE_ID}?v=...
+NOTION_DATABASE_ID=your_notion_database_id_here

package/skills/meeting-brief-generator/README.md

@@ -0,0 +1,90 @@
+# meeting-brief-generator
+
+<img width="1280" height="640" alt="meeting-brief-generator" src="https://github.com/user-attachments/assets/30026bc4-657a-4ce9-8c0e-4dd2654783f8" />
+
+
+Walk into every sales or business development call prepared. Give the skill a company name and it runs targeted research, synthesizes a 1-page brief, and optionally saves it to Notion.
+
+## What It Does
+
+- Runs 6-8 targeted Tavily searches covering company overview, recent news, tech stack, product, competitors, funding, and contact background
+- Synthesizes results into a structured 1-page brief using Gemini
+- Every claim cites a source URL from the research
+- Optionally saves the brief to a Notion database
+- Handles low-data companies by marking gaps instead of inventing content
+
+## Requirements
+
+| Requirement | Purpose | How to Set Up |
+|------------|---------|--------------|
+| Tavily API key | Company research | app.tavily.com, API Keys |
+| Gemini API key | Brief synthesis | aistudio.google.com, Get API key |
+| Notion token (optional) | Saving briefs | notion.so/my-integrations |
+
+## Setup
+
+```bash
+cp .env.example .env
+```
+
+Fill in:
+- `TAVILY_API_KEY` (required)
+- `GEMINI_API_KEY` (required)
+- `NOTION_TOKEN` and `NOTION_DATABASE_ID` (optional, for saving briefs)
+
+## How to Use
+
+Basic brief with company only:
+
+```
+"Prepare me for a meeting with Stripe next Tuesday"
+"Generate a meeting brief for Vercel"
+"Research Acme Corp before my call tomorrow"
+```
+
+With contact and meeting type:
+
+```
+"Prepare a discovery call brief for Linear. I'm meeting with the VP Engineering, Jordan Lee."
+"Create a pre-call brief for Notion. Demo call on April 20."
+```
+
+Save to Notion:
+
+```
+"Generate a meeting brief for Figma and save it to Notion"
+```
+
+## Brief Sections
+
+| Section | Content |
+|---------|---------|
+| Company Snapshot | What they do, size, funding stage, HQ |
+| Recent News | Last 30 days, source URLs |
+| Decision Maker | Name, title, background (if contact provided) |
+| Tech Stack Signals | Tools spotted in job posts, blog, GitHub |
+| Competitive Context | Who they compete with and how |
+| Talking Points | Because/mention/to formula, 3-5 bullets |
+| Open Questions | Company-specific discovery questions |
+
+## Output Format
+
+One page, under 400 words. Every claim has a source URL. Talking points follow the format: "Because [finding from research], mention [point] to [goal]."
+
+## Project Structure
+
+```
+meeting-brief-generator/
+├── SKILL.md
+├── README.md
+├── .env.example
+├── evals/
+│   └── evals.json
+└── references/
+    ├── brief-format.md
+    └── output-template.md
+```
+
+## License
+
+MIT