agentleFS
HiyokoSauna37HiyokoSauna37/claudecode-re-toolkit/.claude/skills/toolkit-setup/SKILL.md

toolkit-setup

Skill17 starsChanged 2 months agoMITView on GitHub

マルウェア解析ツールキットの初回セットアップおよび再セットアップを実行する。前提条件チェック、.env作成、Dockerイメージビルド、YARA/CAPA/FLOSS/dumpulatorインストール、VMware環境構築ガイドを含む。 Use when: "セットアップ", "setup", "初期設定", "環境構築", "toolkit-setup", ".envを作りたい", "Dockerビルド", "再セットアップ", "VMware設定", ".env編集", "FLOSS", "dumpulator" Do NOT use for: マルウェア解析の実行(malware-fetch / ghidra-headless / malware-sandbox を使用)、個別ツールのトラブルシューティング

  • Reads credentials
  • Installs packages

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. WingedGuardian/skyrimvr-claude-toolkit★ 22same name
    2. MatthewYe/autopilot-toolkit★ 2same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

Files
SKILL.md

Toolkit Setup

Instructions

Step 1: 環境診断(Phase 0)

以下をすべて並列で実行し、各コンポーネントの状態を判定する:

# 並列実行(すべて独立)
cat .env 2>/dev/null | head -1                                    # .env 存在
docker info > /dev/null 2>&1                                      # Docker Desktop
docker images malware-fetch-browser:latest --format "{{.ID}}"         # malware-fetch イメージ
docker ps -a --filter "name=ghidra-headless" --format "{{.Status}}" # ghidra コンテナ
ls "C:/Program Files (x86)/VMware/VMware Workstation/vmrun.exe" 2>/dev/null  # VMware
go version 2>/dev/null                                            # Go
python --version 2>/dev/null                                      # Python
ls tools/ghidra-headless/yara-rules/ 2>/dev/null                  # YARA rules
pip show yara-python 2>/dev/null                                  # yara-python
pip show flare-capa 2>/dev/null                                   # flare-capa(malware-sandbox 用。ghidra-headless はイメージ内に同梱済み)
pip show flare-floss 2>/dev/null                                  # flare-floss(malware-sandbox 用。ghidra-headless はイメージ内に同梱済み)
pip show dumpulator 2>/dev/null                                   # dumpulator (新機能)

診断結果を以下の形式で表示:

環境診断結果:
[OK] Docker Desktop      起動中
[!!] .env               未作成
[OK] malware-fetch-browser   ビルド済み
[!!] ghidra-headless     未作成
...

Step 2: モード選択(Phase 1)

AskUserQuestion で以下を確認:

Q1: セットアップモード(header: "モード")

選択肢メリットデメリット
対話型ウィザード1ステップずつ確認。安心。途中キャンセル容易確認回数が多く時間がかかる
一括セットアップ全体計画を提示→承認後に一気に実行。速い個別ステップの細かい調整がしにくい

Q2: セットアップ範囲(header: "範囲", multiSelect: true) Phase 0 の結果に基づき、未セットアップ項目をデフォルトで含める。 セットアップ済み項目は「(済)」と明記し、再セットアップの選択肢として残す。

  • .env 作成/編集
  • Docker: malware-fetch イメージビルド
  • Docker: ghidra-headless コンテナ起動
  • YARA/CAPA セットアップ
  • FLOSS/dumpulator セットアップ(pip install flare-floss dumpulator)— malware-sandbox 用のホスト側インストール。ghidra-headless の capa/FLOSS は Dockerfile でピン止め済み(flare-capa 9.4.0 / flare-floss 3.1.1 + capa ルール同梱)なのでホストには不要
  • VMware Sandbox 環境構築ガイド

Step 3: 手順実行(Phase 2)

選択されたモードの reference を Read して手順に従う:

  • 対話型: references/interactive-setup.md
  • 一括型: references/batch-setup.md

任意コンポーネント(既定のセットアップには含めない): x64dbg-automate による Level 3 デバッガ自動制御。 ホスト側は Python 3.11+ と pip install "x64dbg_automate==0.9.2"(必ず == でピン)、 ゲスト側はプラグイン v0.8.1-ghost_fungus の配置と x64dbg.ini への [XAutomate] Mode=remote 追記が要る。 .env の VM_X64DBG_HOST / VM_X64DBG_REQ_PORT / VM_X64DBG_PUB_PORT を併せて設定する。 手順は tools/malware-sandbox/docs/VM-SETUP.md の «Step 3.5»、検証は python tools/malware-sandbox/x64dbg_driver.py --selftest(VM 不要)。

Examples

初回セットアップ(典型的な流れ)

ユーザー: "セットアップして"
→ Phase 0: 環境診断(.env未作成、Docker起動中、他は未セットアップ)
→ Phase 1: モード選択 → 対話型、全項目選択
→ Phase 2: .env作成 → malware-fetchビルド → ghidra起動 → YARA/CAPA → VMware確認
→ 最終サマリー表示

再セットアップ(Dockerイメージ更新)

ユーザー: "Dockerイメージを再ビルドしたい"
→ Phase 0: 環境診断(.env済、Docker済、ghidra済)
→ Phase 1: モード選択 → Docker: malware-fetch のみ選択
→ Phase 2: キャッシュ有無を確認 → 再ビルド → 検証

.env の部分編集

ユーザー: ".envのVT APIキーを変更したい"
→ Phase 0: .env存在確認
→ Phase 1: .env作成/編集 のみ選択
→ Phase 2: 既存値をマスク表示 → 変更項目を確認 → 差分適用

Troubleshooting

Docker Desktop が起動していない

症状: docker info が失敗
原因: Docker Desktop が未起動またはWSL2バックエンドが未設定
解決: Docker Desktop を起動してから /toolkit-setup を再実行

Docker ビルドが失敗する

症状: docker build がエラーで停止
よくある原因:
- ネットワーク接続不良(パッケージダウンロード失敗)
- ディスク容量不足
解決:
1. docker system prune で不要イメージを削除
2. ネットワーク接続を確認して再実行
3. --no-cache オプションで再ビルド

ghidra-headless コンテナが起動しない

症状: docker compose up -d 後に docker exec が失敗
よくある原因:
- ポート競合
- メモリ不足(MAXMEM=4G が必要)
解決:
1. docker logs ghidra-headless でエラー確認
2. docker compose -f tools/ghidra-headless/docker-compose.yml down && up -d で再作成

VMware vmrun が応答しない

症状: vmrun -T ws list がハングまたはエラー
よくある原因:
- VMware Workstation サービスが未起動
- vmrun.exe のパスが不正
解決:
1. VMRUN_PATH が正しいか確認
2. VMware Workstation を起動してから再実行
3. 詳細は references/guides/troubleshooting.md(malware-sandbox スキル)を参照

.env の既存値を上書きしてしまった

症状: .env の値が意図せず変更された
解決: git checkout .env で復元(.gitignoreに含まれる場合は不可)
予防: このスキルは既存 .env を上書きせず差分提案のみ行う設計

セキュリティルール

  • .env 内の機密情報(パスワード、APIキー)は表示時に必ずマスクする
  • 既存の .env がある場合は上書きせず、差分のみ提案する
  • Docker イメージの再ビルドは --no-cache の要否をユーザーに確認する
  • VMware VM の起動・操作は必ずユーザー確認を取る

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.