jpskill.com
🛠️ 開発・MCP コミュニティ

claude-skills-sync-init

リポジトリ内の`.agents/skills`と`.claude/skills`フォルダを自動で同期させ、必要なスクリプトや設定をpackage.jsonに追加して、新しいプロジェクトでも既存のプロジェクトでもスキル同期の仕組みを簡単に導入・開始できるようにするSkill。

📜 元の英語説明(参考)

Bootstrap Claude skill-sync automation in any repository. Use when users ask to set up `.agents/skills` to `.claude/skills` syncing, generate `skills:sync:*` scripts, inject package.json scripts/postinstall hooks, or initialize this sync workflow in a new or existing project.

🇯🇵 日本人クリエイター向け解説

一言でいうと

リポジトリ内の`.agents/skills`と`.claude/skills`フォルダを自動で同期させ、必要なスクリプトや設定をpackage.jsonに追加して、新しいプロジェクトでも既存のプロジェクトでもスキル同期の仕組みを簡単に導入・開始できるようにするSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o claude-skills-sync-init.zip https://jpskill.com/download/9716.zip && unzip -o claude-skills-sync-init.zip && rm claude-skills-sync-init.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/9716.zip -OutFile "$d\claude-skills-sync-init.zip"; Expand-Archive "$d\claude-skills-sync-init.zip" -DestinationPath $d -Force; ri "$d\claude-skills-sync-init.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して claude-skills-sync-init.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → claude-skills-sync-init フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Claude Skills Sync Init

本 Skill は、対象プロジェクトで skills 同期機能を初期化する際に使用します。

Overview

目標は、対象リポジトリに以下の機能を自動的に実装することです。

  1. --source、--targets、--dry-run をサポートする scripts/sync-llm-skills.ts を生成します。
  2. scripts.skills:sync:llm コマンドを注入します。
  3. devDependencies.is-ci が存在することを自動的に確認します（存在しない場合は自動的に書き込みます）。
  4. postinstall を冪等な方法でマージし、デフォルトで is-ci CI guard を注入します。
  5. 同期対象は .claude/skills のみとします。
  6. 同期プロセスはアトミックな切り替えを採用し、コピー失敗時にターゲットディレクトリを空にすることを回避します。
  7. 対象リポジトリの .gitignore に /.claude/skills が含まれていることを自動的に確認します。

Execution Flow

  1. コンテキストの収集
  • 対象リポジトリのルートディレクトリを確認します（package.json が存在すること）。
  • ソースディレクトリがまだ .agents/skills（デフォルト値）を使用しているかどうかを確認します。
  • ターゲットディレクトリが .claude/skills（デフォルトかつ唯一のターゲット）であることを確認します。
  1. 自動実装スクリプトの実行
  • 対象リポジトリで以下を実行します。
    node /path/to/claude-skills-sync-init/scripts/bootstrap-sync-skills.mjs --project /path/to/target-repo
  • オプションの引数：
    • --script-name（デフォルト skills:sync:llm）
    • --script-path（デフォルト scripts/sync-llm-skills.ts）
    • --skip-postinstall（postinstall の注入をスキップ）
  • --script-name は文字セット [A-Za-z0-9:._-]+ のみ許可され、不正な値の場合は失敗して終了する必要があります。
  1. 同期コマンドの実行検証
  • デフォルトの検証：
    pnpm run skills:sync:llm -- --dry-run
  • 明示的なターゲットの指定（オプション）：
    pnpm run skills:sync:llm -- --targets=claude
  1. 変更の概要の出力
  • 新規/更新されたファイルをリストします。
    • scripts/sync-llm-skills.ts
    • package.json
    • .gitignore
  • is-ci 依存関係の処理結果を説明します（新規または既存）。
  • postinstall のマージ結果を説明します（新規作成、追加、または既存の場合はスキップ）、および CI guard が有効かどうかを示します。
  • .gitignore の /.claude/skills 忽略規則の処理結果を説明します（新規または既存）。
  • 検証コマンドと実行結果を添付します。

Resources

  • 自動実装スクリプト：scripts/bootstrap-sync-skills.mjs
  • 同期スクリプトテンプレート：assets/templates/sync-llm-skills.ts
  • 統合チェックリスト：references/integration-checklist.md

Guardrails

  1. 対象リポジトリのルートディレクトリでのみ実行します（package.json の読み書きが可能である必要があります）。
  2. 冪等性を維持します。繰り返し実行しても、コマンドまたは postinstall スニペットが重複して注入されないようにします。
  3. 既存の postinstall ロジックを上書きせず、追加およびマージのみを行います。
  4. ソースディレクトリが存在しない場合は、失敗してゼロ以外の終了コードを返す必要があります。
  5. postinstall の重複排除は、緩いサブストリングマッチングを使用せず、完全なコマンド/完全なスクリプト呼び出しマッチングを行う必要があります。
  6. 同期の実装は、最初に一時ディレクトリにコピーし、次にターゲットディレクトリを切り替え、失敗した場合はロールバックを試みる必要があります。
  7. 対象リポジトリに is-ci がない場合は、devDependencies.is-ci を自動的に書き込み、CI guard コマンドを注入する必要があります。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Claude Skills Sync Init

在目标项目中初始化 skills 同步能力时，使用本 Skill。

Overview

目标是在目标仓库自动落地以下能力：

  1. 生成 scripts/sync-llm-skills.ts，支持 --source、--targets、--dry-run。
  2. 注入 scripts.skills:sync:llm 命令。
  3. 自动确保 devDependencies.is-ci 存在（缺失时自动写入）。
  4. 以幂等方式合并 postinstall，默认注入 is-ci CI guard。
  5. 同步目标仅为 .claude/skills。
  6. 同步过程采用原子切换，避免复制失败时清空目标目录。
  7. 自动确保目标仓库 .gitignore 包含 /.claude/skills。

Execution Flow

  1. 收集上下文
  • 确认目标仓库根目录（存在 package.json）。
  • 确认源目录是否仍使用 .agents/skills（默认值）。
  • 确认目标目录为 .claude/skills（默认且唯一目标）。
  1. 执行自动落地脚本
  • 在目标仓库执行：
    node /path/to/claude-skills-sync-init/scripts/bootstrap-sync-skills.mjs --project /path/to/target-repo
  • 可选参数：
    • --script-name（默认 skills:sync:llm）
    • --script-path（默认 scripts/sync-llm-skills.ts）
    • --skip-postinstall（跳过 postinstall 注入）
  • --script-name 仅允许字符集 [A-Za-z0-9:._-]+，非法值必须失败退出。
  1. 运行同步命令验证
  • 默认验证：
    pnpm run skills:sync:llm -- --dry-run
  • 显式指定目标（可选）：
    pnpm run skills:sync:llm -- --targets=claude
  1. 输出变更摘要
  • 列出新增/更新文件：
    • scripts/sync-llm-skills.ts
    • package.json
    • .gitignore
  • 说明 is-ci 依赖处理结果（新增或已存在）。
  • 说明 postinstall 合并结果（新建、追加、或已存在跳过），并标注 CI guard 是否生效。
  • 说明 .gitignore 的 /.claude/skills 忽略规则处理结果（新增或已存在）。
  • 附上验证命令与执行结果。

Resources

  • 自动落地脚本：scripts/bootstrap-sync-skills.mjs
  • 同步脚本模板：assets/templates/sync-llm-skills.ts
  • 集成检查清单：references/integration-checklist.md

Guardrails

  1. 仅在目标仓库根目录执行（必须可读写 package.json）。
  2. 保持幂等：重复执行不得重复注入命令或 postinstall 片段。
  3. 不覆盖已有 postinstall 逻辑，只做追加合并。
  4. 源目录不存在时必须失败并返回非零退出码。
  5. postinstall 去重必须做完整命令/完整脚本调用匹配，不能使用宽松子串匹配。
  6. 同步实现必须优先复制到临时目录，再切换目标目录，并在失败时尝试回滚。
  7. 若目标仓库缺少 is-ci，必须自动写入 devDependencies.is-ci，再注入 CI guard 命令。