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:
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user