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 "" -``` +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.