poddrill 0.1.0 → 0.1.1

package/.agents/skills/poddrill/SKILL.md

@@ -4,16 +4,24 @@ description: >-
   Transcribe a podcast episode into timed text, group the voices, and store
   a summary whose paragraphs cite that text. The agent reads the text, names
   the voices, and writes the summary words. PodDrill stores the episode.
-  Use when fetching episode audio, starting a transcript, labeling speakers,
-  or writing a summary. When a session has no PodDrill tools, register the
-  client before transcribing. Do not use it to change the poddrill TypeScript.
+  Use when the user says to set up PodDrill on this computer, when fetching
+  episode audio, starting a transcript, labeling speakers, or writing a summary.
+  When a session has no PodDrill tools, install the requirements, register the
+  client, and set up the workspace before transcribing. Do not use it to change
+  the poddrill TypeScript.
 ---
 
 # PodDrill
 
 PodDrill is a toolset to make transcription and summary of podcast audio streamlined and structured. You may also use it for any other audio. It maps an episode (the audio) to cues, clusters those cues into speaker groups, and stores summaries. You decide how to use the toolset to answer user's request of audio summary.
 
-Set up a workspace once, when it is missing. After that, read the one guide for the part you are doing. Leave the other guides unread. If an episode already has the asset you need, read it. Do not reprocess the audio again.
+Find the package, install the requirements, register the client, and set up the workspace once. After that, read the one guide for the part you are doing. Leave the other guides unread. If an episode already has the asset you need, read it. Do not reprocess the audio again.
+
+## Find the package
+
+The npm package is `poddrill`. Before it is on disk, read the published `version` and use `npx -y poddrill@<version>`. After it is installed, `<version>` is the `version` field in that package's `package.json`. Do not use `@latest`.
+
+Install Node.js 22.18 or newer, `ffmpeg` on `PATH`, and the Python package `cactus-needle` 3.2.0. The npm package named cactus-needle is a different package. Place the ECAPA file at `~/.cache/poddrill/ecapa/voxceleb_ECAPA512.onnx`, or set `PODDRILL_EMBED_WEIGHTS` to another path. This package does not install those, and it has no download URL for the ECAPA file.
 
 ## Cues
 

package/README.md

@@ -1,29 +1,25 @@
 # PodDrill
 
-PodDrill transcribes episode audio into timed text, groups the voices, and stores a summary.
+PodDrill is a skill that transcribes episode audio into timed text, groups the voices, and stores a summary.
 
-## Requirements
-
-Use Node.js 22.18 or newer.
-
-A transcript also needs ffmpeg and the Python package cactus-needle 3.2.0. That Python package is not the npm package named cactus-needle.
-
-## Run
+## Say this
 
-From this repository, run the command.
+Copy this to the agent.
 
+```text
+Set up PodDrill on this computer.
 ```
-node src/cli.ts
-```
 
-`npm run build` writes `dist`. The published package runs `dist/cli.js`, because Node does not strip TypeScript inside `node_modules`.
+The npm package is `poddrill`. The agent installs that package and the requirements below, then follows the skill shipped in the package.
+
+## Requirements
 
-The npm package is not published yet. After it is published, run `npx poddrill`.
+The computer that runs PodDrill needs Node.js 22.18 or newer, `ffmpeg` on `PATH`, and the Python package `cactus-needle` 3.2.0. The npm package named cactus-needle is a different package.
 
-## Workspace
+That computer also needs the ECAPA weights file. The default path is `~/.cache/poddrill/ecapa/voxceleb_ECAPA512.onnx`. `PODDRILL_EMBED_WEIGHTS` selects another path.
 
-Set `PODDRILL_WORKSPACE` to a directory outside this repository. Then run `poddrill setup` in that directory.
+Grok Bot cannot write its server entry. It prints the custom server to add. Add that server in the Grok Bot chat.
 
 ## License
 
-MIT License. Copyright (c) 2026 Jianyu Zhao.
+MIT License. Copyright 2026 Jianyu Zhao.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poddrill",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Transcribe episode audio into timed text, group the voices, and store a summary.",
   "license": "MIT",
   "author": "Jianyu Zhao",