gigaclaw 1.4.0

package/templates/skills/youtube-transcript/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: youtube-transcript
+description: Fetch transcripts from YouTube videos for summarization and analysis.
+---
+
+# YouTube Transcript
+
+Fetch transcripts from YouTube videos.
+
+## Setup
+
+```bash
+cd skills/youtube-transcript
+npm install
+```
+
+## Usage
+
+```bash
+skills/youtube-transcript/transcript.js <video-id-or-url>
+```
+
+Accepts video ID or full URL:
+- `EBw7gsDPAYQ`
+- `https://www.youtube.com/watch?v=EBw7gsDPAYQ`
+- `https://youtu.be/EBw7gsDPAYQ`
+
+## Output
+
+Timestamped transcript entries:
+
+```
+[0:00] All right. So, I got this UniFi Theta
+[0:15] I took the camera out, painted it
+[1:23] And here's the final result
+```
+
+## Notes
+
+- Requires the video to have captions/transcripts available
+- Works with auto-generated and manual transcripts

package/templates/skills/youtube-transcript/package-lock.json

@@ -0,0 +1,24 @@
+{
+  "name": "youtube-transcript-skill",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "youtube-transcript-skill",
+      "version": "1.0.0",
+      "dependencies": {
+        "youtube-transcript-plus": "^1.2.0"
+      }
+    },
+    "node_modules/youtube-transcript-plus": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/youtube-transcript-plus/-/youtube-transcript-plus-1.2.0.tgz",
+      "integrity": "sha512-SRjVft8V+vUulMKgakgfzC+pnFLSy4tolX7xGnSvp9juUNocikMFmUx5GlhzLDILzxYrijcYtmNqz0qyklnPmA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    }
+  }
+}

package/templates/skills/youtube-transcript/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "youtube-transcript-skill",
+  "version": "1.0.0",
+  "type": "module",
+  "dependencies": {
+    "youtube-transcript-plus": "^1.2.0"
+  }
+}

package/templates/skills/youtube-transcript/transcript.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+import { YoutubeTranscript } from 'youtube-transcript-plus';
+
+function extractVideoId(input) {
+  if (!input) return null;
+
+  // Already a plain video ID (11 characters, alphanumeric + dash/underscore)
+  if (/^[A-Za-z0-9_-]{11}$/.test(input)) {
+    return input;
+  }
+
+  try {
+    const url = new URL(input);
+
+    // youtu.be/VIDEO_ID
+    if (url.hostname === 'youtu.be') {
+      return url.pathname.slice(1);
+    }
+
+    // youtube.com/watch?v=VIDEO_ID
+    if (url.hostname === 'www.youtube.com' || url.hostname === 'youtube.com') {
+      return url.searchParams.get('v');
+    }
+  } catch {
+    // Not a URL — treat as video ID anyway
+    return input;
+  }
+
+  return null;
+}
+
+function decodeHtmlEntities(str) {
+  return str
+    .replace(/'/g, "'")
+    .replace(/&/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#(\d+);/g, (_, num) => String.fromCharCode(Number(num)));
+}
+
+function formatTime(seconds) {
+  const totalSeconds = Math.floor(seconds);
+  const mins = Math.floor(totalSeconds / 60);
+  const secs = totalSeconds % 60;
+  return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+
+async function main() {
+  const input = process.argv[2];
+
+  if (!input) {
+    console.error('Usage: transcript.js <video-id-or-url>');
+    process.exit(1);
+  }
+
+  const videoId = extractVideoId(input);
+
+  if (!videoId) {
+    console.error(`Error: Could not extract video ID from "${input}"`);
+    process.exit(1);
+  }
+
+  try {
+    const transcript = await YoutubeTranscript.fetchTranscript(videoId);
+
+    if (!transcript || transcript.length === 0) {
+      console.error('No transcript available for this video.');
+      process.exit(1);
+    }
+
+    for (const entry of transcript) {
+      const time = formatTime(entry.offset);
+      const text = decodeHtmlEntities(entry.text.replace(/\n/g, ' ')).trim();
+      console.log(`[${time}] ${text}`);
+    }
+  } catch (err) {
+    console.error(`Error fetching transcript: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();