1仕組みと動作原理
「実行可能なコードを内包する」タイプのSkill:SKILL.mdには3つの技術(CSSグラデーションキーフレーム、Three.jsによるGLSLフラグメントシェーダー、Canvas 2Dパーティクル)の完全な実行可能実装がインライン化されており、エージェントは成果物にコピーするだけですぐに利用可能——機能は外部サービスではなくインラインコードによって実現されます。
This skill is self-contained: every technique below ships its own runnable code — CSS, GLSL, and canvas — with no external dependencies beyond Three.js where a shader is involved.
シームレスなループ再生は厳密な技術要件:CSSは始点と終点のキーフレームの一致に依存し、canvas/JSはloop phase=(t%PERIOD)/PERIOD×2πでsin/cosを駆動して周期末尾で正確に巻き戻し、shaderはノイズのスクロールをノイズ空間内の閉じた円として設計します。
Any motion built only from `sin`/`cos` of `phase` (or integer multiples) loops seamlessly.
パフォーマンスとアクセシビリティをコードレベルの規律として徹底:devicePixelRatioを最大2に制限、120点超のパーティクル間接続ではO(n²)から空間ハッシュへ切り替え、prefers-reduced-motionでは静止フレームへフォールバック、visibilitychangeとIntersectionObserverで画面外や非表示時に描画を一時停止します。
honor `prefers-reduced-motion`, and pause when offscreen or the tab is hidden.
納品規約=単一ファイルHTML:背景、フォアグラウンドテキストのサンプル、単一のアニメーションドライバー、決定論的フレームキャプチャ用の?t=N freeze harnessをすべてインライン化し、ブラウザで開くだけで即座に動作します。
A motion background ships as **one `.html` file that opens directly in a browser** — markup, the background, and (for shader/canvas) Three.js or canvas JS from CDN, all inline.
自己完結型の検証ループ:リポジトリのscripts/にseek-shot.sh(npx playwrightで?t=Nフレームをキャプチャ)とcontact-sheet.sh(ffmpegでコンタクトシートを作成)が用意されており、SKILL.mdは開始・中間・終了の3フレームをキャプチャして品質、アーティファクト、ループの継ぎ目を検証することを要求します。
**Packaged helper** (`scripts/`): `scripts/seek-shot.sh anim.html 0 1.5 3` freezes the `?t=N` harness and screenshots each moment; `scripts/contact-sheet.sh sheet.png frame-*.png` tiles them for one-glance review. See `scripts/README.md`.
詳細な実装はreferences/background-recipes.mdに集約:マルチblob CSSメッシュ(blur+screenブレンド)、マウス視差と真のシームレスループを備えた完全なオーロラ、グリッド最適化とマウス反発を備えた星座フィールド、閉じたパスのノイズスクロール、統合ライフサイクルマネージャーを網羅しています。
references/background-recipes.md — fuller drop-in implementations: a richer multi-blob CSS mesh with blur, the complete Three.js aurora shader with mouse parallax and a true seamless-loop time wrap
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| package | three.js(交付 HTML 运行时依赖;仅 shader 路线,CDN 或 bundler 引入) |
| cli | npx playwright screenshot(验证闭环;seek-shot.sh 内部调用,首次运行自动拉取 Chromium) |
| cli | ffmpeg(contact-sheet.sh 依赖,本地拼图) |
| cli | 仓库 scripts/seek-shot.sh、contact-sheet.sh(POSIX bash 本地工具) |
4推奨統制措置と判定根拠
- scripts/: ローカルスクリプトまたはコマンドの実行: SKILL.mdはエージェントに対しリポジトリ内スクリプトの実行を指示:`scripts/seek-shot.sh anim.html <t...>`(内部でnpx playwrightを実行)
- 网络端点: 外部ネットワークアクセスの宣言: Skill自体の実行パスに外部へのネットワーク送信はなし(スクリーンショットの対象はローカルのfile:// HTML)。Playwrightの初回実行時にChromiumをダウンロードする可能性あり(seek-shot)
- 本地工作目录: ファイルの読み書きと成果物の出力: 作業ディレクトリに成果物bg.htmlを出力(単一ファイル出力規約)
5二重目の独立検証
- [ok] 脚本引用真实性 — SKILL.md 引用的 scripts/seek-shot.sh、contact-sheet.sh、scripts/README.md 在仓库根存在;seek-shot.sh 输出 frame-<t>.png 与 SKILL.md 用法一致。
- [ok] 『no external dependencies beyond Three.js』反查 — SKILL.md/recipes 未出现其他 import/外部 URL 请求(CDN 仅以文字提及 three.js);CSS/canvas 路线零依赖属实。
- [ok] 无凭证/无隐藏网络调用 — token/curl/exec 类扫描零命中;playwright 只访问 file:// 本地页;唯一网络相关=playwright 首跑下载 Chromium(一次性工具安装)与交付页打开时 CDN 加载。
- [discrepancy] 打包粒度风险(scripts/ 不在 skill 目录) — skill 自述依赖的验证脚本位于仓库根 scripts/;若通过 skills.sh 只安装单个 skill 目录(不含 repo 根),scripts/ 引用与 .claude-plugin 打包关系悬空——从源码无法确认各安装方式的粒度,展示层应提示按整 repo/pack 安装。
- [ok] 代码正确性抽查(无缝循环/暂停逻辑) — phase 回卷公式、首尾关键帧一致、uPhase=2π 圆环回原点、IntersectionObserver running 逻辑在 SKILL.md 与 recipes 中一致;未发现逻辑矛盾。
6結論
6e74dc92e650a613…