fix(skills): frontmatter lint — using-interns v0.3.1 (YAML+≤1024), using-wiki-graph v0.1.1 (≤1024), ralph-loop-execution frontmatter, remove using-yt-tools stub, add scripts/lint-skills.py + wire into update.{sh,ps1}
This commit is contained in:
@@ -1,3 +1,13 @@
|
||||
---
|
||||
name: ralph-loop-execution
|
||||
version: 0.1.0
|
||||
description: >
|
||||
Execute a ralph-loop task: read the task's **Verifier:** oracle-command,
|
||||
do the work, run the verifier, record the attempt (or harness-fail on
|
||||
infra breakage). Use when a task block contains `**Verifier:** <command>`
|
||||
or `**Max-Attempts:**`. Activates at the start of any verifier-gated task.
|
||||
---
|
||||
|
||||
# ralph-loop-execution
|
||||
|
||||
## When to Use
|
||||
|
||||
@@ -1,7 +1,16 @@
|
||||
---
|
||||
name: using-interns
|
||||
version: 0.3.0
|
||||
description: Use when delegating predictable bulk reads or summarization to cheap intern LLMs via the local `interns` MCP server (`mcp__interns__bulk_text_read`, `mcp__interns__transcript_distill`, etc.) so Claude saves Anthropic quota. Activated by `delegate to interns when allowed` in CLAUDE.md or explicit phrases like "use interns", "delegate to an intern", "разреши интернов", "allow interns". **Also activates proactively when Claude is about to read 3+ files for context, read a single file >400 lines for non-edit purposes, or distill a long transcript — surface the offer "знаю, что есть интерны — заюзать?" before proceeding, even without an explicit user phrase.** Per-session permission grant mirrors `project-discipline` Rule 4: ask-mode default, conversational grant / revoke, always-ask paths for `.env` / secrets / keys / SSH / credentials even with active grant, transitive rule (Claude can't bypass by reading the file itself and forwarding content), session-end reset. Skip for architecture, debugging, auth / payments, final commit messages, or final user-facing text.
|
||||
version: 0.3.1
|
||||
description: >
|
||||
Use when delegating predictable bulk reads or summarization to cheap intern LLMs via the l
|
||||
ocal `interns` MCP server (`mcp__interns__bulk_text_read`, `mcp__interns__transcript_disti
|
||||
ll`, etc.) so the main agent saves quota. Activated by `delegate to interns when allowed`
|
||||
in CLAUDE.md or explicit phrases: «разреши интернов», "use interns", "allow interns". Also
|
||||
activates proactively when about to read 3+ files for context, a single file >400 lines,
|
||||
or distill a long transcript — surface the offer «знаю, что есть интерны — заюзать?» first
|
||||
. Per-session grant mirrors project-discipline Rule 4: ask-mode default, always-ask for `.
|
||||
env`/secrets/keys/SSH/credentials, transitive rule, session-end reset. Skip for architectu
|
||||
re, debugging, auth/payments, final commits, final user-facing text.
|
||||
---
|
||||
|
||||
# Using the `interns` MCP server
|
||||
|
||||
@@ -1,7 +1,16 @@
|
||||
---
|
||||
name: using-wiki-graph
|
||||
version: 0.1.0
|
||||
description: "Use when a question is RELATIONAL about a wiki — «что связывает X и Y», «как связаны X и Y», «путь между X и Y», «через что X выходит на Y», «what connects X and Y», «how is X related to Y», «shortest path between pages» — or about wiki STRUCTURE/HEALTH — «что ссылается на X», «кто линкует X», «соседи страницы X», «сироты в вики», «битые/dangling ссылки», «сколько связных компонент», «backlinks of X», «orphan pages». Triggers the `wiki-graph` MCP server (`mcp__wiki-graph__path|neighbors|backlinks|orphans|stats`), which runs a deterministic BFS over `[[wikilinks]]` server-side. The failure-mode this guards: on a relational question the agent does a semantic read of one page and STOPS, never walking the multi-hop link chain (0% recall on such queries vs 67% for graph BFS). Precondition: only DENSE corpora (e.g. modulair-wiki, 150 linked pages) — skip on sparse wikis (the shared meta-wiki has ~1 link total, graph is empty). Each tool needs `corpus` = absolute path to the `.wiki/` dir. Read-only, no grant needed. Skip for content/semantic questions answerable by reading a single page, and for wikis with no `[[links]]`."
|
||||
version: 0.1.1
|
||||
description: >
|
||||
Use when a question is RELATIONAL about a wiki — «что связывает X и Y», «как связаны», «пу
|
||||
ть между X и Y», «what connects X and Y», «shortest path» — or about STRUCTURE/HEALTH — «ч
|
||||
то ссылается на X», «backlinks of X», «сироты», «битые ссылки», «orphan pages». Triggers `
|
||||
wiki-graph` MCP (`mcp__wiki-graph__path|neighbors|backlinks|orphans|stats`) — deterministi
|
||||
c BFS over `[[wikilinks]]` server-side. Guarded failure-mode: on relational questions the
|
||||
agent reads one page and STOPS, never walking multi-hop chains. Precondition: DENSE corpor
|
||||
a only (e.g. modulair-wiki, 150 pages); skip sparse wikis (shared meta-wiki ≈ empty graph)
|
||||
. Each tool needs `corpus` = absolute path to `.wiki/`. Read-only, no grant. Skip for sing
|
||||
le-page content questions and wikis without `[[links]]`.
|
||||
---
|
||||
|
||||
# using-wiki-graph
|
||||
|
||||
@@ -1,59 +0,0 @@
|
||||
---
|
||||
name: using-yt-tools
|
||||
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
|
||||
|
||||
This skill has migrated to the **`OpeItcLoc03/yt-tools` Claude Code plugin**.
|
||||
It is no longer maintained in the `claude-skills` repository — all future
|
||||
changes (CLI flag updates, new flows, bug fixes, version bumps) ship with
|
||||
the plugin distribution.
|
||||
|
||||
## Why the move
|
||||
|
||||
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 --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`.
|
||||
|
||||
## How to install the replacement
|
||||
|
||||
```text
|
||||
/plugin marketplace add OpeItcLoc03/claude-plugins
|
||||
/plugin install yt-tools@opeitcloc03-claude-plugins
|
||||
```
|
||||
|
||||
The first session after install will run the plugin's `SessionStart` hook
|
||||
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
|
||||
|
||||
After `/plugin install yt-tools@opeitcloc03-claude-plugins` reports
|
||||
success on your machine — delete this directory:
|
||||
|
||||
```bash
|
||||
rm -rf ~/projects/claude-skills/skills/using-yt-tools/
|
||||
```
|
||||
|
||||
This stub has no trigger phrases, so it remains inert and will not
|
||||
double-activate alongside the plugin's skill. It exists only as a sign
|
||||
post for anyone still looking for the old location.
|
||||
|
||||
## Source pointers
|
||||
|
||||
- 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/> (deferred post-v1; not yet published)
|
||||
- Design rationale: `OpeItcLoc03/common/.wiki/concepts/yt-tools-distribution.md`
|
||||
Reference in New Issue
Block a user