docs(using-yt-tools): align deprecation stub with shipped plugin install path (v0.4.1)

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) <noreply@anthropic.com>
This commit is contained in:
2026-05-26 10:15:46 +03:00
parent d83c1c9fec
commit 957f4ab091

View File

@@ -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: <https://github.com/OpeItcLoc03/yt-tools>
- Marketplace catalog: <https://github.com/OpeItcLoc03/claude-plugins>
- Bundled canonical SKILL: `skills/using-yt-tools/SKILL.md` in the plugin repo
- PyPI: <https://pypi.org/project/yt-tools/> (live once Phase 4 publishes)
- PyPI: <https://pypi.org/project/yt-tools/> (deferred post-v1; not yet published)
- Design rationale: `OpeItcLoc03/common/.wiki/concepts/yt-tools-distribution.md`