thepopebot 1.2.72-beta.21 → 1.2.72-beta.22

package/lib/chat/actions.js

@@ -202,6 +202,21 @@ export async function triggerUpgrade() {
   return { success: true };
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Feature flags
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Get feature flags based on environment configuration.
+ * Features gated behind CLAUDE_CODE_OAUTH_TOKEN (Claude Pro/Max subscription features).
+ * @returns {Promise<{ claudeWorkspace: boolean }>}
+ */
+export async function getFeatureFlags() {
+  await requireAuth();
+  const claudeWorkspace = !!process.env.CLAUDE_CODE_OAUTH_TOKEN;
+  return { claudeWorkspace };
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // API Key actions
 // ─────────────────────────────────────────────────────────────────────────────

package/lib/chat/components/app-sidebar.js

@@ -2,7 +2,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from "react";
 import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon, ArrowUpCircleIcon, LifeBuoyIcon, GitPullRequestIcon } from "./icons.js";
-import { getUnreadNotificationCount, getPullRequestCount, getAppVersion } from "../actions.js";
+import { getUnreadNotificationCount, getPullRequestCount, getAppVersion, getFeatureFlags } from "../actions.js";
 import { SidebarHistory } from "./sidebar-history.js";
 import { SidebarUserNav } from "./sidebar-user-nav.js";
 import { UpgradeDialog } from "./upgrade-dialog.js";
@@ -30,6 +30,7 @@ function AppSidebar({ user }) {
   const [updateAvailable, setUpdateAvailable] = useState(null);
   const [changelog, setChangelog] = useState(null);
   const [upgradeOpen, setUpgradeOpen] = useState(false);
+  const [features, setFeatures] = useState({ claudeWorkspace: false });
   useEffect(() => {
     function fetchCounts() {
       getUnreadNotificationCount().then((count) => setUnreadCount(count)).catch(() => {
@@ -41,6 +42,10 @@ function AppSidebar({ user }) {
     const interval = setInterval(fetchCounts, 10 * 60 * 1e3);
     return () => clearInterval(interval);
   }, []);
+  useEffect(() => {
+    getFeatureFlags().then((flags) => setFeatures(flags)).catch(() => {
+    });
+  }, []);
   useEffect(() => {
     getAppVersion().then(({ version: version2, updateAvailable: updateAvailable2, changelog: changelog2 }) => {
       setVersion(version2);
@@ -77,8 +82,10 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "/",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => {
+                onClick: (e) => {
+                  e.preventDefault();
                   navigateToChat(null);
                   setOpenMobile(false);
                 },
@@ -94,10 +101,8 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "/chats",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => {
-                  window.location.href = "/chats";
-                },
                 children: [
                   /* @__PURE__ */ jsx(MessageIcon, { size: 16 }),
                   !collapsed && /* @__PURE__ */ jsx("span", { children: "Chats" })
@@ -110,10 +115,8 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "/swarm",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => {
-                  window.location.href = "/swarm";
-                },
                 children: [
                   /* @__PURE__ */ jsx(SwarmIcon, { size: 16 }),
                   !collapsed && /* @__PURE__ */ jsx("span", { children: "Swarm" })
@@ -126,10 +129,8 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "/notifications",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => {
-                  window.location.href = "/notifications";
-                },
                 children: [
                   /* @__PURE__ */ jsx(BellIcon, { size: 16 }),
                   !collapsed && /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-2", children: [
@@ -146,10 +147,8 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "/pull-requests",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => {
-                  window.location.href = "/pull-requests";
-                },
                 children: [
                   /* @__PURE__ */ jsx(GitPullRequestIcon, { size: 16 }),
                   !collapsed && /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-2", children: [
@@ -192,8 +191,10 @@ function AppSidebar({ user }) {
             /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
               SidebarMenuButton,
               {
+                href: "https://www.skool.com/ai-architects",
+                target: "_blank",
+                rel: "noopener noreferrer",
                 className: collapsed ? "justify-center" : "",
-                onClick: () => window.open("https://www.skool.com/ai-architects", "_blank"),
                 children: [
                   /* @__PURE__ */ jsx(LifeBuoyIcon, { size: 16 }),
                   !collapsed && /* @__PURE__ */ jsx("span", { children: "Support" })

package/lib/chat/components/app-sidebar.jsx

@@ -2,7 +2,7 @@
 
 import { useState, useEffect } from 'react';
 import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon, ArrowUpCircleIcon, LifeBuoyIcon, GitPullRequestIcon } from './icons.js';
-import { getUnreadNotificationCount, getPullRequestCount, getAppVersion } from '../actions.js';
+import { getUnreadNotificationCount, getPullRequestCount, getAppVersion, getFeatureFlags } from '../actions.js';
 import { SidebarHistory } from './sidebar-history.js';
 import { SidebarUserNav } from './sidebar-user-nav.js';
 import { UpgradeDialog } from './upgrade-dialog.js';
@@ -31,6 +31,7 @@ export function AppSidebar({ user }) {
   const [updateAvailable, setUpdateAvailable] = useState(null);
   const [changelog, setChangelog] = useState(null);
   const [upgradeOpen, setUpgradeOpen] = useState(false);
+  const [features, setFeatures] = useState({ claudeWorkspace: false });
 
   // Fetch badge counts (notifications + PRs) — run immediately, then every 10 minutes
   useEffect(() => {
@@ -47,6 +48,13 @@ export function AppSidebar({ user }) {
     return () => clearInterval(interval);
   }, []);
 
+  // Feature flags — one-time on mount
+  useEffect(() => {
+    getFeatureFlags()
+      .then((flags) => setFeatures(flags))
+      .catch(() => {});
+  }, []);
+
   // Version check — one-time on mount
   useEffect(() => {
     getAppVersion()
@@ -88,8 +96,10 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="/"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => {
+                  onClick={(e) => {
+                    e.preventDefault();
                     navigateToChat(null);
                     setOpenMobile(false);
                   }}
@@ -109,10 +119,8 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="/chats"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => {
-                    window.location.href = '/chats';
-                  }}
                 >
                   <MessageIcon size={16} />
                   {!collapsed && <span>Chats</span>}
@@ -129,10 +137,8 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="/swarm"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => {
-                    window.location.href = '/swarm';
-                  }}
                 >
                   <SwarmIcon size={16} />
                   {!collapsed && <span>Swarm</span>}
@@ -149,10 +155,8 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="/notifications"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => {
-                    window.location.href = '/notifications';
-                  }}
                 >
                   <BellIcon size={16} />
                   {!collapsed && (
@@ -183,10 +187,8 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="/pull-requests"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => {
-                    window.location.href = '/pull-requests';
-                  }}
                 >
                   <GitPullRequestIcon size={16} />
                   {!collapsed && (
@@ -249,8 +251,10 @@ export function AppSidebar({ user }) {
             <Tooltip>
               <TooltipTrigger asChild>
                 <SidebarMenuButton
+                  href="https://www.skool.com/ai-architects"
+                  target="_blank"
+                  rel="noopener noreferrer"
                   className={collapsed ? 'justify-center' : ''}
-                  onClick={() => window.open('https://www.skool.com/ai-architects', '_blank')}
                 >
                   <LifeBuoyIcon size={16} />
                   {!collapsed && <span>Support</span>}

package/lib/chat/components/chats-page.js

@@ -103,10 +103,15 @@ function ChatsPage({ session }) {
     /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between mb-6", children: [
       /* @__PURE__ */ jsx("h1", { className: "text-2xl font-semibold", children: "Chats" }),
       /* @__PURE__ */ jsxs(
-        "button",
+        "a",
         {
-          onClick: () => navigateToChat(null),
+          href: "/",
+          onClick: (e) => {
+            e.preventDefault();
+            navigateToChat(null);
+          },
           className: "inline-flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium bg-foreground text-background hover:bg-foreground/90",
+          style: { textDecoration: "inherit" },
           children: [
             /* @__PURE__ */ jsx(PlusIcon, { size: 14 }),
             "New chat"
@@ -180,12 +185,21 @@ function ChatRow({ chat, onNavigate, onDelete, onStar, onRename }) {
     setEditTitle(chat.title || "");
   };
   return /* @__PURE__ */ jsxs(
-    "div",
+    "a",
     {
+      href: `/chat/${chat.id}`,
       className: "relative group flex items-center gap-3 px-3 py-3 cursor-pointer hover:bg-muted/50 rounded-md",
+      style: { textDecoration: "inherit", color: "inherit" },
       onMouseEnter: () => setHovered(true),
       onMouseLeave: () => setHovered(false),
-      onClick: () => !editing && onNavigate(chat.id),
+      onClick: (e) => {
+        if (editing) {
+          e.preventDefault();
+          return;
+        }
+        e.preventDefault();
+        onNavigate(chat.id);
+      },
       children: [
         /* @__PURE__ */ jsx(MessageIcon, { size: 16 }),
         /* @__PURE__ */ jsxs("div", { className: "flex-1 min-w-0", children: [

package/lib/chat/components/chats-page.jsx

@@ -122,13 +122,15 @@ export function ChatsPage({ session }) {
       {/* Header */}
       <div className="flex items-center justify-between mb-6">
         <h1 className="text-2xl font-semibold">Chats</h1>
-        <button
-          onClick={() => navigateToChat(null)}
+        <a
+          href="/"
+          onClick={(e) => { e.preventDefault(); navigateToChat(null); }}
           className="inline-flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium bg-foreground text-background hover:bg-foreground/90"
+          style={{ textDecoration: 'inherit' }}
         >
           <PlusIcon size={14} />
           New chat
-        </button>
+        </a>
       </div>
 
       {/* Search */}
@@ -226,11 +228,17 @@ function ChatRow({ chat, onNavigate, onDelete, onStar, onRename }) {
   };
 
   return (
-    <div
+    <a
+      href={`/chat/${chat.id}`}
       className="relative group flex items-center gap-3 px-3 py-3 cursor-pointer hover:bg-muted/50 rounded-md"
+      style={{ textDecoration: 'inherit', color: 'inherit' }}
       onMouseEnter={() => setHovered(true)}
       onMouseLeave={() => setHovered(false)}
-      onClick={() => !editing && onNavigate(chat.id)}
+      onClick={(e) => {
+        if (editing) { e.preventDefault(); return; }
+        e.preventDefault();
+        onNavigate(chat.id);
+      }}
     >
       <MessageIcon size={16} />
       <div className="flex-1 min-w-0">
@@ -325,6 +333,6 @@ function ChatRow({ chat, onNavigate, onDelete, onStar, onRename }) {
         }}
         onCancel={() => setConfirmDelete(false)}
       />
-    </div>
+    </a>
   );
 }

package/lib/chat/components/sidebar-history-item.js

@@ -27,9 +27,11 @@ function SidebarHistoryItem({ chat, isActive, onDelete, onStar, onRename }) {
           /* @__PURE__ */ jsxs(
             SidebarMenuButton,
             {
+              href: `/chat/${chat.id}`,
               className: "pr-8",
               isActive,
-              onClick: () => {
+              onClick: (e) => {
+                e.preventDefault();
                 navigateToChat(chat.id);
                 setOpenMobile(false);
               },

package/lib/chat/components/sidebar-history-item.jsx

@@ -27,9 +27,11 @@ export function SidebarHistoryItem({ chat, isActive, onDelete, onStar, onRename
         onMouseLeave={() => setHovered(false)}
       >
         <SidebarMenuButton
+          href={`/chat/${chat.id}`}
           className="pr-8"
           isActive={isActive}
-          onClick={() => {
+          onClick={(e) => {
+            e.preventDefault();
             navigateToChat(chat.id);
             setOpenMobile(false);
           }}

package/lib/chat/components/sidebar-user-nav.js

@@ -29,20 +29,18 @@ function SidebarUserNav({ user, collapsed }) {
       ] })
     ] }) }),
     /* @__PURE__ */ jsxs(DropdownMenuContent, { align: "start", side: "top", className: "w-56", children: [
-      /* @__PURE__ */ jsxs(DropdownMenuItem, { onClick: () => {
-        window.location.href = "/settings";
-      }, children: [
+      /* @__PURE__ */ jsx(DropdownMenuItem, { asChild: true, children: /* @__PURE__ */ jsxs("a", { href: "/settings", style: { textDecoration: "inherit", color: "inherit" }, children: [
         /* @__PURE__ */ jsx(SettingsIcon, { size: 14 }),
         /* @__PURE__ */ jsx("span", { className: "ml-2", children: "Settings" })
-      ] }),
+      ] }) }),
       mounted && /* @__PURE__ */ jsxs(DropdownMenuItem, { onClick: () => setTheme(theme === "dark" ? "light" : "dark"), children: [
         theme === "dark" ? /* @__PURE__ */ jsx(SunIcon, { size: 14 }) : /* @__PURE__ */ jsx(MoonIcon, { size: 14 }),
         /* @__PURE__ */ jsx("span", { className: "ml-2", children: theme === "dark" ? "Light Mode" : "Dark Mode" })
       ] }),
-      /* @__PURE__ */ jsxs(DropdownMenuItem, { onClick: () => window.open("https://github.com/stephengpope/thepopebot/issues", "_blank"), children: [
+      /* @__PURE__ */ jsx(DropdownMenuItem, { asChild: true, children: /* @__PURE__ */ jsxs("a", { href: "https://github.com/stephengpope/thepopebot/issues", target: "_blank", rel: "noopener noreferrer", style: { textDecoration: "inherit", color: "inherit" }, children: [
         /* @__PURE__ */ jsx(BugIcon, { size: 14 }),
         /* @__PURE__ */ jsx("span", { className: "ml-2", children: "Report Issues" })
-      ] }),
+      ] }) }),
       /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
       /* @__PURE__ */ jsxs(
         DropdownMenuItem,

package/lib/chat/components/sidebar-user-nav.jsx

@@ -43,9 +43,11 @@ export function SidebarUserNav({ user, collapsed }) {
             </SidebarMenuButton>
           </DropdownMenuTrigger>
           <DropdownMenuContent align="start" side="top" className="w-56">
-            <DropdownMenuItem onClick={() => { window.location.href = '/settings'; }}>
-              <SettingsIcon size={14} />
-              <span className="ml-2">Settings</span>
+            <DropdownMenuItem asChild>
+              <a href="/settings" style={{ textDecoration: 'inherit', color: 'inherit' }}>
+                <SettingsIcon size={14} />
+                <span className="ml-2">Settings</span>
+              </a>
             </DropdownMenuItem>
             {mounted && (
               <DropdownMenuItem onClick={() => setTheme(theme === 'dark' ? 'light' : 'dark')}>
@@ -53,9 +55,11 @@ export function SidebarUserNav({ user, collapsed }) {
                 <span className="ml-2">{theme === 'dark' ? 'Light Mode' : 'Dark Mode'}</span>
               </DropdownMenuItem>
             )}
-            <DropdownMenuItem onClick={() => window.open('https://github.com/stephengpope/thepopebot/issues', '_blank')}>
-              <BugIcon size={14} />
-              <span className="ml-2">Report Issues</span>
+            <DropdownMenuItem asChild>
+              <a href="https://github.com/stephengpope/thepopebot/issues" target="_blank" rel="noopener noreferrer" style={{ textDecoration: 'inherit', color: 'inherit' }}>
+                <BugIcon size={14} />
+                <span className="ml-2">Report Issues</span>
+              </a>
             </DropdownMenuItem>
             <DropdownMenuSeparator />
             <DropdownMenuItem

package/lib/code/ws-proxy.js

@@ -30,6 +30,13 @@ export function attachCodeProxy(server) {
     const match = req.url.match(/^\/code\/([^/]+)\/ws$/);
     if (!match) return;
 
+    if (!process.env.CLAUDE_CODE_OAUTH_TOKEN) {
+      console.log('[ws-proxy] rejected: CLAUDE_CODE_OAUTH_TOKEN not set');
+      socket.write('HTTP/1.1 403 Forbidden\r\n\r\n');
+      socket.destroy();
+      return;
+    }
+
     if (!await isAuthenticated(req)) {
       console.log('[ws-proxy] rejected: unauthenticated upgrade');
       socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thepopebot",
-  "version": "1.2.72-beta.21",
+  "version": "1.2.72-beta.22",
   "type": "module",
   "description": "Create autonomous AI agents with a two-layer architecture: Next.js Event Handler + Docker Agent.",
   "bin": {

package/templates/app/code/[claudeWorkspaceId]/page.js

@@ -1,8 +1,12 @@
 import { auth } from 'thepopebot/auth';
+import { redirect } from 'next/navigation';
 import { CodePage } from 'thepopebot/code';
+import { getFeatureFlags } from 'thepopebot/chat/actions';
 
 export default async function CodeRoute({ params }) {
   const session = await auth();
+  const { claudeWorkspace } = await getFeatureFlags();
+  if (!claudeWorkspace) redirect('/');
   const { claudeWorkspaceId } = await params;
   return <CodePage session={session} claudeWorkspaceId={claudeWorkspaceId} />;
 }

package/templates/skills/google-docs/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: google-docs
+description: "Create and manage Google Docs on a shared drive via service account."
+---
+
+# Google Docs
+
+Create and manage Google Docs on a shared drive using a service account.
+
+## Environment Variables
+
+- `GOOGLE_SERVICE_ACCOUNT_JSON` — Service account credentials JSON
+- `GOOGLE_SHARED_DRIVE_ID` — Shared drive ID
+
+## Commands
+
+### Create a Google Doc
+
+```bash
+skills/google-docs/create.sh <title> <content> <parent_folder_id>
+```
+
+Creates a new Google Doc with the given title and text content in the specified folder. Returns the document ID and URL.

package/templates/skills/google-docs/create.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TITLE="${1:?Usage: create.sh <title> <content> <parent_folder_id>}"
+CONTENT="${2:?Usage: create.sh <title> <content> <parent_folder_id>}"
+PARENT_FOLDER_ID="${3:?Usage: create.sh <title> <content> <parent_folder_id>}"
+
+if [ -z "${GOOGLE_SERVICE_ACCOUNT_JSON:-}" ]; then
+  echo "Error: GOOGLE_SERVICE_ACCOUNT_JSON is not set" >&2
+  exit 1
+fi
+
+# Extract service account email and private key
+SA_EMAIL=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.client_email')
+SA_KEY=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.private_key')
+TOKEN_URI=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.token_uri')
+
+# Build JWT with both drive and docs scopes
+NOW=$(date +%s)
+EXP=$((NOW + 3600))
+HEADER=$(echo -n '{"alg":"RS256","typ":"JWT"}' | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+CLAIMS=$(printf '{"iss":"%s","scope":"https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents","aud":"%s","iat":%d,"exp":%d}' \
+  "$SA_EMAIL" "$TOKEN_URI" "$NOW" "$EXP" | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+SIGNING_INPUT="${HEADER}.${CLAIMS}"
+SIGNATURE=$(printf '%s' "$SIGNING_INPUT" | openssl dgst -sha256 -sign <(echo "$SA_KEY") | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+JWT="${SIGNING_INPUT}.${SIGNATURE}"
+
+# Exchange JWT for access token
+ACCESS_TOKEN=$(curl -s -X POST "$TOKEN_URI" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${JWT}" | jq -r '.access_token')
+
+if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" = "null" ]; then
+  echo "Error: Failed to obtain access token" >&2
+  exit 1
+fi
+
+# Create Google Doc via Drive API (creates empty doc in the shared drive)
+METADATA=$(jq -n --arg title "$TITLE" --arg parent "$PARENT_FOLDER_ID" \
+  '{name: $title, mimeType: "application/vnd.google-apps.document", parents: [$parent]}')
+
+CREATE_RESPONSE=$(curl -s -X POST \
+  "https://www.googleapis.com/drive/v3/files?supportsAllDrives=true&includeItemsFromAllDrives=true" \
+  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d "$METADATA")
+
+DOC_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id')
+if [ -z "$DOC_ID" ] || [ "$DOC_ID" = "null" ]; then
+  echo "Error: Failed to create document" >&2
+  echo "$CREATE_RESPONSE" >&2
+  exit 1
+fi
+
+# Insert content using Docs API batchUpdate
+if [ -n "$CONTENT" ]; then
+  UPDATE_BODY=$(jq -n --arg text "$CONTENT" \
+    '{requests: [{insertText: {location: {index: 1}, text: $text}}]}')
+
+  curl -s -X POST \
+    "https://docs.googleapis.com/v1/documents/${DOC_ID}:batchUpdate" \
+    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
+    -H "Content-Type: application/json" \
+    -d "$UPDATE_BODY" > /dev/null
+fi
+
+echo "Created Google Doc: $TITLE"
+echo "Doc ID: $DOC_ID"
+echo "URL: https://docs.google.com/document/d/${DOC_ID}/edit"

package/templates/skills/google-drive/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: google-drive
+description: "Interact with Google Drive shared drives via service account. Supports list, upload, download, delete operations."
+---
+
+# Google Drive
+
+Interact with Google Drive shared drives using a service account.
+
+## Environment Variables
+
+- `GOOGLE_SERVICE_ACCOUNT_JSON` — Service account credentials JSON
+- `GOOGLE_SHARED_DRIVE_ID` — Shared drive ID
+
+## Commands
+
+### List files in a folder
+
+```bash
+skills/google-drive/list.sh <folder_id>
+```
+
+Lists files and folders in the given folder. Use `$GOOGLE_SHARED_DRIVE_ID` for the root.
+
+### Upload a file
+
+```bash
+skills/google-drive/upload.sh <local_file> <parent_folder_id> <filename>
+```
+
+Uploads a local file to the specified folder with the given name.
+
+### Download a file
+
+```bash
+skills/google-drive/download.sh <file_id> <local_path>
+```
+
+Downloads a file by ID to a local path.
+
+### Delete a file
+
+```bash
+skills/google-drive/delete.sh <file_id>
+```
+
+Deletes a file by ID.

package/templates/skills/google-drive/delete.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FILE_ID="${1:?Usage: delete.sh <file_id>}"
+
+if [ -z "${GOOGLE_SERVICE_ACCOUNT_JSON:-}" ]; then
+  echo "Error: GOOGLE_SERVICE_ACCOUNT_JSON is not set" >&2
+  exit 1
+fi
+
+# Extract service account email and private key
+SA_EMAIL=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.client_email')
+SA_KEY=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.private_key')
+TOKEN_URI=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.token_uri')
+
+# Build JWT
+NOW=$(date +%s)
+EXP=$((NOW + 3600))
+HEADER=$(echo -n '{"alg":"RS256","typ":"JWT"}' | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+CLAIMS=$(printf '{"iss":"%s","scope":"https://www.googleapis.com/auth/drive","aud":"%s","iat":%d,"exp":%d}' \
+  "$SA_EMAIL" "$TOKEN_URI" "$NOW" "$EXP" | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+SIGNING_INPUT="${HEADER}.${CLAIMS}"
+SIGNATURE=$(printf '%s' "$SIGNING_INPUT" | openssl dgst -sha256 -sign <(echo "$SA_KEY") | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+JWT="${SIGNING_INPUT}.${SIGNATURE}"
+
+# Exchange JWT for access token
+ACCESS_TOKEN=$(curl -s -X POST "$TOKEN_URI" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${JWT}" | jq -r '.access_token')
+
+if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" = "null" ]; then
+  echo "Error: Failed to obtain access token" >&2
+  exit 1
+fi
+
+# Delete file
+HTTP_CODE=$(curl -s -w "%{http_code}" -o /dev/null \
+  -X DELETE \
+  "https://www.googleapis.com/drive/v3/files/${FILE_ID}?supportsAllDrives=true" \
+  -H "Authorization: Bearer ${ACCESS_TOKEN}")
+
+if [ "$HTTP_CODE" -ne 204 ] && [ "$HTTP_CODE" -ne 200 ]; then
+  echo "Error: Delete failed with HTTP $HTTP_CODE" >&2
+  exit 1
+fi
+
+echo "Deleted file: $FILE_ID"

package/templates/skills/google-drive/download.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FILE_ID="${1:?Usage: download.sh <file_id> <local_path>}"
+LOCAL_PATH="${2:?Usage: download.sh <file_id> <local_path>}"
+
+if [ -z "${GOOGLE_SERVICE_ACCOUNT_JSON:-}" ]; then
+  echo "Error: GOOGLE_SERVICE_ACCOUNT_JSON is not set" >&2
+  exit 1
+fi
+
+# Extract service account email and private key
+SA_EMAIL=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.client_email')
+SA_KEY=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.private_key')
+TOKEN_URI=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.token_uri')
+
+# Build JWT
+NOW=$(date +%s)
+EXP=$((NOW + 3600))
+HEADER=$(echo -n '{"alg":"RS256","typ":"JWT"}' | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+CLAIMS=$(printf '{"iss":"%s","scope":"https://www.googleapis.com/auth/drive","aud":"%s","iat":%d,"exp":%d}' \
+  "$SA_EMAIL" "$TOKEN_URI" "$NOW" "$EXP" | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+SIGNING_INPUT="${HEADER}.${CLAIMS}"
+SIGNATURE=$(printf '%s' "$SIGNING_INPUT" | openssl dgst -sha256 -sign <(echo "$SA_KEY") | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+JWT="${SIGNING_INPUT}.${SIGNATURE}"
+
+# Exchange JWT for access token
+ACCESS_TOKEN=$(curl -s -X POST "$TOKEN_URI" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${JWT}" | jq -r '.access_token')
+
+if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" = "null" ]; then
+  echo "Error: Failed to obtain access token" >&2
+  exit 1
+fi
+
+# Download file
+HTTP_CODE=$(curl -s -w "%{http_code}" -o "$LOCAL_PATH" \
+  "https://www.googleapis.com/drive/v3/files/${FILE_ID}?alt=media&supportsAllDrives=true&includeItemsFromAllDrives=true" \
+  -H "Authorization: Bearer ${ACCESS_TOKEN}")
+
+if [ "$HTTP_CODE" -ne 200 ]; then
+  echo "Error: Download failed with HTTP $HTTP_CODE" >&2
+  cat "$LOCAL_PATH" >&2
+  rm -f "$LOCAL_PATH"
+  exit 1
+fi
+
+FILE_SIZE=$(stat -c%s "$LOCAL_PATH" 2>/dev/null || stat -f%z "$LOCAL_PATH" 2>/dev/null)
+echo "Downloaded to: $LOCAL_PATH ($FILE_SIZE bytes)"

package/templates/skills/google-drive/list.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FOLDER_ID="${1:?Usage: list.sh <folder_id>}"
+
+if [ -z "${GOOGLE_SERVICE_ACCOUNT_JSON:-}" ]; then
+  echo "Error: GOOGLE_SERVICE_ACCOUNT_JSON is not set" >&2
+  exit 1
+fi
+
+# Extract service account email and private key
+SA_EMAIL=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.client_email')
+SA_KEY=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.private_key')
+TOKEN_URI=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.token_uri')
+
+# Build JWT
+NOW=$(date +%s)
+EXP=$((NOW + 3600))
+HEADER=$(echo -n '{"alg":"RS256","typ":"JWT"}' | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+CLAIMS=$(printf '{"iss":"%s","scope":"https://www.googleapis.com/auth/drive","aud":"%s","iat":%d,"exp":%d}' \
+  "$SA_EMAIL" "$TOKEN_URI" "$NOW" "$EXP" | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+SIGNING_INPUT="${HEADER}.${CLAIMS}"
+SIGNATURE=$(printf '%s' "$SIGNING_INPUT" | openssl dgst -sha256 -sign <(echo "$SA_KEY") | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+JWT="${SIGNING_INPUT}.${SIGNATURE}"
+
+# Exchange JWT for access token
+ACCESS_TOKEN=$(curl -s -X POST "$TOKEN_URI" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${JWT}" | jq -r '.access_token')
+
+if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" = "null" ]; then
+  echo "Error: Failed to obtain access token" >&2
+  exit 1
+fi
+
+# List files
+RESPONSE=$(curl -s -X GET \
+  "https://www.googleapis.com/drive/v3/files?q='${FOLDER_ID}'+in+parents&supportsAllDrives=true&includeItemsFromAllDrives=true&corpora=allDrives&fields=files(id,name,mimeType,size,modifiedTime)" \
+  -H "Authorization: Bearer ${ACCESS_TOKEN}")
+
+echo "$RESPONSE" | jq -r '.files[] | "\(.id)\t\(.name)\t\(.mimeType)\t\(.size // "N/A")\t\(.modifiedTime)"' 2>/dev/null || echo "$RESPONSE"

package/templates/skills/google-drive/upload.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+LOCAL_FILE="${1:?Usage: upload.sh <local_file> <parent_folder_id> <filename>}"
+PARENT_FOLDER_ID="${2:?Usage: upload.sh <local_file> <parent_folder_id> <filename>}"
+FILENAME="${3:?Usage: upload.sh <local_file> <parent_folder_id> <filename>}"
+
+if [ ! -f "$LOCAL_FILE" ]; then
+  echo "Error: File not found: $LOCAL_FILE" >&2
+  exit 1
+fi
+
+if [ -z "${GOOGLE_SERVICE_ACCOUNT_JSON:-}" ]; then
+  echo "Error: GOOGLE_SERVICE_ACCOUNT_JSON is not set" >&2
+  exit 1
+fi
+
+# Extract service account email and private key
+SA_EMAIL=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.client_email')
+SA_KEY=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.private_key')
+TOKEN_URI=$(echo "$GOOGLE_SERVICE_ACCOUNT_JSON" | jq -r '.token_uri')
+
+# Build JWT
+NOW=$(date +%s)
+EXP=$((NOW + 3600))
+HEADER=$(echo -n '{"alg":"RS256","typ":"JWT"}' | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+CLAIMS=$(printf '{"iss":"%s","scope":"https://www.googleapis.com/auth/drive","aud":"%s","iat":%d,"exp":%d}' \
+  "$SA_EMAIL" "$TOKEN_URI" "$NOW" "$EXP" | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+SIGNING_INPUT="${HEADER}.${CLAIMS}"
+SIGNATURE=$(printf '%s' "$SIGNING_INPUT" | openssl dgst -sha256 -sign <(echo "$SA_KEY") | openssl base64 -e -A | tr '+/' '-_' | tr -d '=')
+JWT="${SIGNING_INPUT}.${SIGNATURE}"
+
+# Exchange JWT for access token
+ACCESS_TOKEN=$(curl -s -X POST "$TOKEN_URI" \
+  -H "Content-Type: application/x-www-form-urlencoded" \
+  -d "grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${JWT}" | jq -r '.access_token')
+
+if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" = "null" ]; then
+  echo "Error: Failed to obtain access token" >&2
+  exit 1
+fi
+
+# Detect MIME type from extension
+EXT="${LOCAL_FILE##*.}"
+case "${EXT,,}" in
+  jpg|jpeg) MIME_TYPE="image/jpeg" ;;
+  png)      MIME_TYPE="image/png" ;;
+  gif)      MIME_TYPE="image/gif" ;;
+  webp)     MIME_TYPE="image/webp" ;;
+  mp4)      MIME_TYPE="video/mp4" ;;
+  webm)     MIME_TYPE="video/webm" ;;
+  pdf)      MIME_TYPE="application/pdf" ;;
+  txt)      MIME_TYPE="text/plain" ;;
+  json)     MIME_TYPE="application/json" ;;
+  csv)      MIME_TYPE="text/csv" ;;
+  *)        MIME_TYPE="application/octet-stream" ;;
+esac
+
+# Upload file using multipart upload
+METADATA=$(printf '{"name":"%s","parents":["%s"]}' "$FILENAME" "$PARENT_FOLDER_ID")
+
+RESPONSE=$(curl -s -X POST \
+  "https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart&supportsAllDrives=true&includeItemsFromAllDrives=true" \
+  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
+  -F "metadata=${METADATA};type=application/json" \
+  -F "file=@${LOCAL_FILE};type=${MIME_TYPE}")
+
+FILE_ID=$(echo "$RESPONSE" | jq -r '.id')
+if [ -z "$FILE_ID" ] || [ "$FILE_ID" = "null" ]; then
+  echo "Error: Upload failed" >&2
+  echo "$RESPONSE" >&2
+  exit 1
+fi
+
+echo "Uploaded: $FILENAME"
+echo "File ID: $FILE_ID"

package/templates/skills/kie-ai/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: kie-ai
+description: "Generate images and videos using kie.ai API. Use for AI image and video generation tasks."
+---
+
+# KIE AI
+
+Generate images and videos using the kie.ai API.
+
+## Environment Variables
+
+- `KIE_AI_API_KEY` — API key for kie.ai
+
+## Commands
+
+### Generate an image
+
+```bash
+skills/kie-ai/generate-image.sh <prompt> [aspect_ratio] [resolution] [output_format]
+```
+
+- `prompt` (required) — Text prompt for image generation
+- `aspect_ratio` (optional, default: `auto`) — One of: `auto, 1:1, 1:4, 16:9, 1:8, 21:9, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16`
+- `resolution` (optional, default: `1K`) — One of: `1K, 2K, 4K`
+- `output_format` (optional, default: `jpg`) — One of: `jpg, png`
+
+Downloads the generated image to a local file and prints the path.
+
+### Generate a video
+
+```bash
+skills/kie-ai/generate-video.sh <prompt> [aspect_ratio]
+```
+
+- `prompt` (required) — Text prompt for video generation
+- `aspect_ratio` (optional, default: `16:9`) — One of: `16:9, 9:16, Auto`
+
+Downloads the generated video to a local file and prints the path.

package/templates/skills/kie-ai/generate-image.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROMPT="${1:?Usage: generate-image.sh <prompt> [aspect_ratio] [resolution] [output_format]}"
+ASPECT_RATIO="${2:-auto}"
+RESOLUTION="${3:-1K}"
+OUTPUT_FORMAT="${4:-jpg}"
+
+if [ -z "${KIE_AI_API_KEY:-}" ]; then
+  echo "Error: KIE_AI_API_KEY is not set" >&2
+  exit 1
+fi
+
+# Create task
+BODY=$(jq -n \
+  --arg prompt "$PROMPT" \
+  --arg ar "$ASPECT_RATIO" \
+  --arg res "$RESOLUTION" \
+  --arg fmt "$OUTPUT_FORMAT" \
+  '{
+    model: "nano-banana-2",
+    input: {
+      prompt: $prompt,
+      aspect_ratio: $ar,
+      resolution: $res,
+      output_format: $fmt
+    }
+  }')
+
+echo "Creating image generation task..." >&2
+CREATE_RESPONSE=$(curl -s -X POST \
+  "https://api.kie.ai/api/v1/jobs/createTask" \
+  -H "Authorization: Bearer ${KIE_AI_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$BODY")
+
+TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.data.taskId // .taskId // empty')
+if [ -z "$TASK_ID" ]; then
+  echo "Error: Failed to create task" >&2
+  echo "$CREATE_RESPONSE" >&2
+  exit 1
+fi
+
+echo "Task ID: $TASK_ID — polling for completion..." >&2
+
+# Poll for completion
+while true; do
+  sleep 15
+  STATUS_RESPONSE=$(curl -s -X GET \
+    "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=${TASK_ID}" \
+    -H "Authorization: Bearer ${KIE_AI_API_KEY}" \
+    -H "Content-Type: application/json")
+
+  STATE=$(echo "$STATUS_RESPONSE" | jq -r '.data.state // empty')
+  echo "State: $STATE" >&2
+
+  if [ "$STATE" = "success" ]; then
+    # .data.resultJson is a JSON string — parse it, then get .resultUrls[0]
+    IMAGE_URL=$(echo "$STATUS_RESPONSE" | jq -r '.data.resultJson' | jq -r '.resultUrls[0]')
+    if [ -z "$IMAGE_URL" ] || [ "$IMAGE_URL" = "null" ]; then
+      echo "Error: Could not extract image URL" >&2
+      echo "$STATUS_RESPONSE" >&2
+      exit 1
+    fi
+
+    # Download
+    OUTPUT_FILE="/tmp/kie-image-${TASK_ID}.${OUTPUT_FORMAT}"
+    curl -s -o "$OUTPUT_FILE" "$IMAGE_URL"
+    FILE_SIZE=$(stat -c%s "$OUTPUT_FILE" 2>/dev/null || stat -f%z "$OUTPUT_FILE" 2>/dev/null)
+    echo "Image downloaded: $OUTPUT_FILE ($FILE_SIZE bytes)"
+    exit 0
+  elif [ "$STATE" = "failed" ] || [ "$STATE" = "error" ]; then
+    echo "Error: Image generation failed" >&2
+    echo "$STATUS_RESPONSE" >&2
+    exit 1
+  fi
+done

package/templates/skills/kie-ai/generate-video.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROMPT="${1:?Usage: generate-video.sh <prompt> [aspect_ratio]}"
+ASPECT_RATIO="${2:-16:9}"
+
+if [ -z "${KIE_AI_API_KEY:-}" ]; then
+  echo "Error: KIE_AI_API_KEY is not set" >&2
+  exit 1
+fi
+
+# Create task
+BODY=$(jq -n \
+  --arg prompt "$PROMPT" \
+  --arg ar "$ASPECT_RATIO" \
+  '{
+    prompt: $prompt,
+    model: "veo3_fast",
+    generationType: "TEXT_2_VIDEO",
+    aspect_ratio: $ar
+  }')
+
+echo "Creating video generation task..." >&2
+CREATE_RESPONSE=$(curl -s -X POST \
+  "https://api.kie.ai/api/v1/veo/generate" \
+  -H "Authorization: Bearer ${KIE_AI_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$BODY")
+
+TASK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.data.taskId // .taskId // empty')
+if [ -z "$TASK_ID" ]; then
+  echo "Error: Failed to create task" >&2
+  echo "$CREATE_RESPONSE" >&2
+  exit 1
+fi
+
+echo "Task ID: $TASK_ID — polling for completion..." >&2
+
+# Poll for completion
+while true; do
+  sleep 15
+  STATUS_RESPONSE=$(curl -s -X GET \
+    "https://api.kie.ai/api/v1/veo/record-info?taskId=${TASK_ID}" \
+    -H "Authorization: Bearer ${KIE_AI_API_KEY}" \
+    -H "Content-Type: application/json")
+
+  SUCCESS_FLAG=$(echo "$STATUS_RESPONSE" | jq -r '.data.successFlag // empty')
+  echo "Status check... successFlag=$SUCCESS_FLAG" >&2
+
+  if [ "$SUCCESS_FLAG" = "1" ]; then
+    VIDEO_URL=$(echo "$STATUS_RESPONSE" | jq -r '.data.response.resultUrls[0]')
+    if [ -z "$VIDEO_URL" ] || [ "$VIDEO_URL" = "null" ]; then
+      echo "Error: Could not extract video URL" >&2
+      echo "$STATUS_RESPONSE" >&2
+      exit 1
+    fi
+
+    # Download
+    OUTPUT_FILE="/tmp/kie-video-${TASK_ID}.mp4"
+    curl -s -o "$OUTPUT_FILE" "$VIDEO_URL"
+    FILE_SIZE=$(stat -c%s "$OUTPUT_FILE" 2>/dev/null || stat -f%z "$OUTPUT_FILE" 2>/dev/null)
+    echo "Video downloaded: $OUTPUT_FILE ($FILE_SIZE bytes)"
+    exit 0
+  elif [ "$SUCCESS_FLAG" = "-1" ]; then
+    echo "Error: Video generation failed" >&2
+    echo "$STATUS_RESPONSE" >&2
+    exit 1
+  fi
+done

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();