From 957f4ab0913881fe19db428a5cc29052712a8ae1 Mon Sep 17 00:00:00 2001 From: vitya Date: Tue, 26 May 2026 10:15:46 +0300 Subject: [PATCH] docs(using-yt-tools): align deprecation stub with shipped plugin install path (v0.4.1) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Stub claimed the plugin's SessionStart hook runs `pipx install yt-tools` (PyPI install). v1 retargeted to plugin-only distribution 2026-05-26 — the hook actually runs `pipx install --force "$CLAUDE_PLUGIN_ROOT[full]"` from the plugin's local clone (PyPI release deferred post-v1). Aligned 3 doc locations: - frontmatter description (line 4) — describes local-clone install with [full]-default + core fallback. - "Why the move" § (lines 17-20) — same alignment. - "How to install the replacement" § (lines 31-35) — same alignment. - "Source pointers" PyPI link (line 54) — qualifier "(deferred post-v1; not yet published)". Frontmatter version bumped 0.4.0 → 0.4.1 (PATCH — docs-only, no behavior change). Stub still declares no trigger phrases — remains inert under invoke-by-name to avoid double-activation with the plugin's skill. Closes part of yt-tools-distrib-docs-sync-pypi-deferred (R4 location 4-of-4). Co-Authored-By: Claude Opus 4.7 (1M context) --- skills/using-yt-tools/SKILL.md | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/skills/using-yt-tools/SKILL.md b/skills/using-yt-tools/SKILL.md index 3f30d05..a618b0d 100644 --- a/skills/using-yt-tools/SKILL.md +++ b/skills/using-yt-tools/SKILL.md @@ -1,7 +1,7 @@ --- name: using-yt-tools -version: 0.4.0 -description: DEPRECATED — this skill has migrated to the `OpeItcLoc03/yt-tools` Claude Code plugin (canonical source). To restore yt-tools functionality, install the plugin via `/plugin marketplace add OpeItcLoc03/claude-plugins` followed by `/plugin install yt-tools@opeitcloc03-claude-plugins`. The plugin's bundled SessionStart hook auto-runs `pipx install yt-tools`, and its bundled skill (full English, mixed RU/EN triggers) takes over from this stub. Once the plugin is installed, this `claude-skills/skills/using-yt-tools/` directory becomes redundant and can be deleted. This stub intentionally declares **no trigger phrases** to avoid double-activation with the plugin's skill — it remains inert until invoked by name. +version: 0.4.1 +description: DEPRECATED — this skill has migrated to the `OpeItcLoc03/yt-tools` Claude Code plugin (canonical source). To restore yt-tools functionality, install the plugin via `/plugin marketplace add OpeItcLoc03/claude-plugins` followed by `/plugin install yt-tools@opeitcloc03-claude-plugins`. The plugin's bundled SessionStart hook auto-runs `pipx install --force "$CLAUDE_PLUGIN_ROOT[full]"` (from the plugin's local clone, fallback to core), and its bundled skill (full English, mixed RU/EN triggers) takes over from this stub. Once the plugin is installed, this `claude-skills/skills/using-yt-tools/` directory becomes redundant and can be deleted. This stub intentionally declares **no trigger phrases** to avoid double-activation with the plugin's skill — it remains inert until invoked by name. --- # using-yt-tools — deprecated stub @@ -15,8 +15,10 @@ the plugin distribution. Bundling the skill into a self-contained plugin (Python CLI + skill + hooks + LICENSE in one repo) lets one user-action install everything: the -plugin's `SessionStart` hook auto-runs `pipx install yt-tools` and probes -`ffmpeg`, and the bundled skill activates the same three flows +plugin's `SessionStart` hook auto-runs +`pipx install --force "$CLAUDE_PLUGIN_ROOT[full]"` (from the plugin's local +clone, not PyPI) and probes `ffmpeg`, and the bundled skill activates the +same three flows (iterative-watch / targeted-frames / audio-analysis) without any separate `claude-skills` install step. See the design rationale in `OpeItcLoc03/common/.wiki/concepts/yt-tools-distribution.md`. @@ -29,9 +31,11 @@ plugin's `SessionStart` hook auto-runs `pipx install yt-tools` and probes ``` The first session after install will run the plugin's `SessionStart` hook -to install the PyPI `yt-tools` package and probe `ffmpeg`. From there the -plugin's bundled skill (canonical English version, mixed RU/EN triggers) -takes over. +to install yt-tools from the plugin's local clone (via +`pipx install --force "$CLAUDE_PLUGIN_ROOT[full]"`, falling back to core +if the `[full]` extras fail) and probe `ffmpeg`. From there the plugin's +bundled skill (canonical English version, mixed RU/EN triggers) takes +over. ## What to do with this stub @@ -51,5 +55,5 @@ post for anyone still looking for the old location. - Plugin repository: - Marketplace catalog: - Bundled canonical SKILL: `skills/using-yt-tools/SKILL.md` in the plugin repo -- PyPI: (live once Phase 4 publishes) +- PyPI: (deferred post-v1; not yet published) - Design rationale: `OpeItcLoc03/common/.wiki/concepts/yt-tools-distribution.md`