From dad835fff7a80340c5a159042aad8a7b7dc131c1 Mon Sep 17 00:00:00 2001
From: alexion <contact@alexion.dev>
Date: Thu, 27 Aug 2026 19:14:11 -0400
Subject: [PATCH] Clarify YouTube transcript wrapper usage

---
 AGENTS.md                                 | 2 ++
 skills/ingest-youtube-transcript/SKILL.md | 8 ++------
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index bc3c9fd..d2fb1d8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -27,3 +27,5 @@ Personal agent skills packaged through Nix.
   Treat deliberate ambiguity as part of the skill's design.
   Customize only the parts required to fit the local workflow.
   Do not turn incidental choices into new contracts.
+- Document helper commands with their location, not only a bare `./helper` invocation.
+  Agents may run skill instructions from the caller's current working directory instead of the skill directory.
diff --git a/skills/ingest-youtube-transcript/SKILL.md b/skills/ingest-youtube-transcript/SKILL.md
index 168c4ba..d5fefa4 100644
--- a/skills/ingest-youtube-transcript/SKILL.md
+++ b/skills/ingest-youtube-transcript/SKILL.md
@@ -11,11 +11,7 @@ Create durable output when the user requests it or active project conventions re
 
 ## Helper command
 
-Run from this skill directory:
-
-```bash
-./fetch_transcript "<youtube_url>"
-```
+Run the `fetch_transcript` wrapper provided by this skill for the YouTube URL.
 
 The command prints JSON to stdout:
 
@@ -31,7 +27,7 @@ The command exits non-zero on failure and writes the error to stderr.
 
 ## Ingest workflow
 
-1. Run `./fetch_transcript` for the YouTube URL.
+1. Run the `fetch_transcript` wrapper provided by this skill for the YouTube URL.
 2. Read the returned `title` and `transcript`.
 3. Build source understanding from the transcript.
 4. Respond to the user's request in chat by default.