AI コーディングエージェントに「この APK を解析して」「この JavaScript の難読化を外して」「この対象に対して授権済みのペネトレーションテストを実施して」と指示するとき、毎回同じ長いプロンプトを書き直していないでしょうか。ツール選定を都度説明し、シナリオ別のプレイブックをコピペし、環境ごとのインストール手順を貼り付ける。この繰り返しは、リバース解析やセキュリティ調査を AI エージェントに任せようとする現場でよく起きています。
一方で、こうした課題に応える「AI エージェント向けのセキュリティスキル集」は近年急増しており、mukul975 の Anthropic-Cybersecurity-Skills(Apache-2.0、27K スター超)や、P4nda0s/reverse-skills(MIT、約 1.9K スター)など、目的と粒度の異なるプロジェクトが並立しています。「20K スターだから良さそう」だけで採用先を決めるのは危険で、対応領域・権限管理・ツール自動導入・クライアント対応の各観点でスコープが大きく異なります。
本記事の対象である zhaoxuya520/reverse-skill は、GitHub 上で 20,003 スター・2,737 フォークを集める、AI コーディングクライアント向けの「リバース解析・授権済みペネトレーションテスト・セキュリティ調査用スキルルーター」パッケージです(gh api /repos/zhaoxuya520/reverse-skill 取得値、2026 年 8 月執筆時点)。archived=false / fork=false / disabled=false で、pushed_at は 2026 年 8 月 6 日と直近まで更新が続いており、公開状態(visibility=public)・アクティブなメンテナンス下にあります。
本記事では、初見のエンジニアが「reverse-skill を自プロジェクトに採用すべきか」「類似 OSS とどう使い分けるべきか」「メンテナンス・ライセンス構成は健全か」を短時間で判断できることを目的に、公式リポジトリ・README・RULES.md・routing.md などのドキュメントに限定して解説します。動作検証・スクリーンショットの取得は行わず、記述はすべて公開ドキュメントの引用と一次情報リンクに紐付けます。
reverse-skill とは何か
一言で言うと
reverse-skill は、Claude Code / Kiro / Cursor / Cline / Codex CLI / Windsurf といった AI コーディングクライアントに対して、「タスクの種類を判定し、対応シナリオごとの手順書(スキル)と必要なツールチェーンを、その場で解決・呼び出せるようにする」ためのスキルルーターパッケージです(公式リポジトリ)。
対応領域はリバースエンジニアリング(RE)、授権済みペネトレーションテスト、セキュリティ調査に絞られています。単一のスキルカタログではなく、「ルール層 → ルーティング層 → Ops 契約層 → シナリオスキル層」という 4 段構成をとる点が最大の特徴です。この構造については、のちほど詳しく整理します。
対応クライアントを README の記載順に整理すると次のとおりです。
AI クライアント | 公式ドキュメントでの位置づけ |
|---|---|
Claude Code | プライマリターゲット。 |
Kiro |
|
Cursor | Settings → Rules → Global Rules に貼り付ける運用(ファイル直接書き込みは公式に想定されず) |
Cline | Settings → Custom Instructions に貼り付ける運用 |
Codex CLI / Windsurf | Global Rules パネルに貼り付ける運用 |
解決している 4 つの問題
reverse-skill が README の "Why this exists" セクションで挙げている、AI エージェントがセキュリティタスクに直面したときの典型的な 4 つの課題は次のとおりです(README.md)。
- ツール選定の判断がつかない: APK・ELF・難読化された JavaScript・PCAP・CTF 問題などを渡されたとき、
jadx/apktool/Frida/IDA/Burp Suiteのどれを使うべきかをエージェントが自力で決められない - シナリオごとのプレイブックが散在している: APK・ELF・JS・PCAP・CTF はそれぞれ別の手順書が必要だが、都度プロンプトに埋め込むと再利用性が低い
- ツール・MCP サーバー・スクリプトがマシンごとに散在している: 環境ごとに導入状況が違うため、同じスキルを再現するコストが高い
- 経験の再利用ができない: 同じ失敗を繰り返し、フィールドノートを構造化して次に活かす仕組みがない
reverse-skill はこの 4 つを、後述する 4 層アーキテクチャと、skills/tool-index.md を SSOT とする「必要になったツールだけをオンデマンドで導入する」仕組みで解決しようとしています。
リポジトリ基本情報
執筆時点の公開情報(gh api /repos/zhaoxuya520/reverse-skill --jq '{...}' の取得値、2026 年 8 月 6 日)に基づく基本メタデータを整理します。
項目 | 値 |
|---|---|
owner / name | zhaoxuya520 / reverse-skill |
説明 | Reverse Engineering / Authorized Penetration Testing / Security Research Skill Router Pack |
主要言語 | PowerShell(Windows がプライマリ経路。Linux/macOS/Kali は Bash 移植あり) |
ライセンス | MIT(本体) |
スター数 | 20,003 |
フォーク数 | 2,737 |
visibility | public |
archived | false |
fork | false |
disabled | false |
最終 push(pushed_at) | 2026-08-06T08:08:15Z |
v1.0.0 リリース日 | 2026-07-18(v1.0.0 リリースノート) |
archived=false / fork=false / disabled=false から、アップストリームとして活発にメンテナンスされているオリジナルのリポジトリであることが確認できます。フォーク由来やアーカイブ済みのプロジェクトを継続利用する際に生じがちなリスクは、少なくともメタデータ上は該当しません。
スター数・注目度の観点では、v1.0.0 の正式リリース(2026-07-18)以降に注目が集まっており、Trendshift の リポジトリスタッツページ にも掲載されています。ただしスター数はプロダクトの品質を保証するものではないため、後続のアーキテクチャ・対応シナリオ・比較の観点と併せて評価する必要があります。
4 層アーキテクチャで解決する仕組み
reverse-skill の設計上の中核は、「AI エージェントがタスクを受け取った瞬間に、どのスキル・どのツールを使うかを、決定論的に一段で解決させる」ためのレイヤ分割です。README と RULES.md、skills/routing.md から読み取れる 4 層を順に整理します。
README では、判定フローが次のように示されています(README.md 抜粋)。
User task
→ RULES.md
→ MASTER-ROUTING / master-route.ps1 (PRIMARY)
→ case-init / scope.md (auth + network_profile; no target ACT until ready)
→ Scenario skill → tools / MCP / scripts
→ timeline + Evidence→Finding→Path → report + field-journal
出典: https://github.com/zhaoxuya520/reverse-skill/blob/main/README.md
レイヤ 1 — ルール(RULES.md)
すべての対応 AI クライアントが最初に読み込むトリガーキーワード集とルーティングルールの SSOT です。「読み込んだら即実行」を強制する Critical ブロックを含み、Claude Code / Kiro / Cursor / Cline / Windsurf 等のグローバル設定に注入して使う設計になっています(RULES.md)。
このレイヤの狙いは、AI エージェントが「セキュリティタスクを受け取ったら、まずルーティング判定に入る」という挙動を、システム全体の前提条件として固定することにあります。プロンプトエンジニアリングをユーザー側に委ねず、SSOT の 1 ファイルに集約している点が特徴です。
レイヤ 2 — ルーティング(MASTER-ROUTING / routing.md)
Target Type(対象種別)× User Intent(意図)× Toolchain(ツールチェーン)の 3 軸マトリクスによって、「どのシナリオスキルを呼ぶか」を 1 ホップで決定します。PowerShell スクリプト master-route.ps1 が PRIMARY として動作し、迷ったときは skills/routing.md のフルマトリクスを参照する運用です。
このレイヤは「30 以上あるシナリオスキルのうち、今のタスクに最適な 1 つを機械的に選び出す」責務を負います。ルーティングの粒度が細かい代わりに、選定ミスによる誤ったツール呼び出しを構造的に減らす狙いがあります。
レイヤ 3 — Ops 契約(scope-contract / evidence-finding-path / role-map)
skills/ops/ 配下にまとまっている「運用契約」レイヤです。とくに重要なのが scope-contract.md で、ケース(案件)ごとにスコープと network_profile を定義し、auth.status=granted になるまでは対象への ACT(能動的操作)を禁止する仕様になっています。授権済みペネトレーションテスト・自社アセット・CTF 対象など、実運用で法的リスクを伴う場面に対して、AI エージェントが対象へ書き込み・スキャン・攻撃を仕掛けないためのガードレールとして機能します。
同じ Ops 契約層には次のファイル群も含まれています。
evidence-finding-path.md: Evidence(証跡)→ Finding(発見)→ Path(攻撃経路)のチェーン管理role-map.md: リード / スペシャリストの役割分担と受け渡しtimeline-workitem.md: タイムラインと workitem のカバレッジ管理sandbox-profile.md: ツールプロファイルskill-supply-chain.md: Agent Skill / MCP のインストールゲート(サプライチェーン対策)IDENTITY.md: 「軽量スキルルーター + ブートストラップ + フィールドジャーナル」というプロダクトアイデンティティの明示
この Ops 契約層は、後述する類似 OSS との比較で reverse-skill の独自性が最も色濃く出るポイントです。
レイヤ 4 — シナリオスキル(30+ カテゴリ)
skills/<category>/ 配下に、シナリオ別の 30 以上のスキルが並びます。APK / iOS / バイナリ / JavaScript / OLLVM / マルウェア / ペネトレーションテスト / CTF / ファームウェア / パッチ差分 / Pwn / EDR bypass / API セキュリティ / サプライチェーン / LLM セキュリティなどが含まれ、CTF 総合は別リポジトリのサブモジュール CTF-Sandbox-Orchestrator/ として 40 以上のサブスキルが束ねられています。
この階層があることで、上位の判定結果に対して「同じフォーマットの手順書 + 参照ツール」が確実に届く構造になっています。個別のスキル一覧はのちほど整理します。
対応シナリオの全体像
シナリオ別対応スキル
対応シナリオは幅広く、skills/routing.md の Target Type マトリクスから主要カテゴリを抜粋すると次のとおりです。
対象タイプ | 主要スキル |
|---|---|
APK / Android |
|
バイナリ exe/dll/so/elf |
|
JavaScript / Web フロントエンド |
|
HTTP キャプチャ / リクエスト再送 | anything-analyzer / Reqable MCP |
ファームウェア / IoT |
|
WASM / Python bytecode / .NET / DSL VM |
|
マルウェア / YARA |
|
macOS / iOS |
|
Go / Rust バイナリ |
|
OLLVM 難読化 |
|
N-day / パッチ差分 |
|
Pwn / exploit 開発 |
|
EDR bypass |
|
API / GraphQL |
|
サプライチェーン / SBOM |
|
LLM / AI セキュリティ |
|
Windows AD / Kerberos |
|
クラウド / K8s |
|
Wi-Fi / 無線 |
|
ハードウェア(UART/JTAG) |
|
プロトコル逆解析 |
|
上表はあくまで抜粋で、完全なマトリクスは skills/routing.md を参照してください。特徴として、「攻撃側」(RE + ペネトレーションテスト + CTF)に寄せた広い網羅性を持ちながら、それぞれの対象種別に対応する専用スキルとツールチェーンが結び付けられています。ペネトレーションテスト用の個別ツール群を横断的に管理する OSS そのものに関心がある場合は、ペネトレーションテスト185ツールを管理するOSS「HackingTool」の仕組みと特徴 も併せて参照してください。
CTF 特化サブモジュール(CTF-Sandbox-Orchestrator)
CTF に関しては、本体とは別に CTF-Sandbox-Orchestrator/ サブモジュールが用意されており、40 以上のサブスキルが CTF 総合用に整理されています。CTF 領域は個別問題ごとの前処理・後処理の型が多岐に渡るため、独立サブモジュール化することで本体側のルーティングをシンプルに保つ構造になっています。ライセンスは本体(MIT)と異なり GNU GPLv3 のため、商用利用時は取り扱いを分ける必要があります(詳細は「導入前に把握しておきたい注意事項」で後述)。
導入・設定の流れ
以降で示す手順は、README.md と README_AI.md の記載内容をそのまま整理したもので、本記事内では動作検証・環境構築は行っていません。導入時は必ず最新の公式ドキュメントを参照してください。
前提ツール
README では次のツールが前提として挙げられています。
- Java / JDK(jadx / apktool 用)
- Node.js 22.12 以上(JavaScript ツールチェーン・MCP サーバー用)
- Python 3.x(Frida・ヘルパースクリプト用)
- コード AI クライアント(Claude Code / Codex CLI / Cursor 等、対応クライアントのいずれか)
主要言語が PowerShell であることが示すとおり、プライマリ動作環境は Windows です。Linux / macOS / Kali 向けには Bash 版のブートストラップスクリプトが同梱されています。
リポジトリ取得と tool-index の更新
README では、リポジトリ取得に次の 1 コマンドが示されています。
git clone https://github.com/zhaoxuya520/reverse-skill.git
出典: https://github.com/zhaoxuya520/reverse-skill/blob/main/README.md
取得後、プラットフォーム別に「どのツールが手元にあるか」を SSOT として持つ skills/tool-index.md を更新します。
プラットフォーム | コマンド |
|---|---|
Windows |
|
Linux / macOS |
|
Kali Linux |
|
このステップの意義は、「以降のブートストラップは、tool-index.md で no となっているツールで、かつ現在のタスクに必要なもののみを対象にする」という判定の起点になる点にあります。あらかじめすべてのツールを一括インストールするのではなく、ケースごとに必要になった時点で導入する運用が明示されています。
AI クライアント別のルーティング設定注入
README_AI.md では、AI クライアントごとにルーティングルールを注入する場所と方法が次のように整理されています(公式ドキュメントの記載を要約)。
クライアント | グローバル設定場所 | 注入方法 |
|---|---|---|
Claude Code |
| 作成または追記 |
Kiro |
| 作成( |
Cursor | 直接ファイル書き込み不可 | Settings → Rules → Global Rules に貼り付け |
Cline | 直接ファイル書き込み不可 | Settings → Custom Instructions に貼り付け |
Windsurf | 直接ファイル書き込み不可 | Global Rules パネルに貼り付け |
「AI クライアント側の設定に注入する」というアプローチのため、ユーザーが個別プロジェクトの .cursorrules などを都度書き直す必要はなく、複数プロジェクトを跨いで同じルーティングを共有できる設計になっています。複数の AI クライアントを別軸で束ねる(プロキシ経由でモデル・エンドポイントを切り替える)別アプローチとの比較には、9routerとは|Claude Code・Cursorを1つに束ねるAIルーターを類似OSSと比較 も参考になります。
類似 OSS との比較で見える独自性
reverse-skill の位置づけを理解するうえで参考になるのが、機能スコープが近い他の OSS プロジェクトとの比較です。「AI エージェント向けのセキュリティスキル集」というカテゴリで検索すると、次の 3 リポジトリが並立して現れます。
- mukul975/Anthropic-Cybersecurity-Skills(Apache-2.0、約 27.4K スター、Python)
- P4nda0s/reverse-skills(MIT、約 1.9K スター)
- meirm/reverse-engineering-skill(ライセンス未設定、小規模)
このうち Anthropic-Cybersecurity-Skills については、防御 + 攻撃の総合スキルカタログとしての立ち位置と 6 フレームワーク準拠の中身を AIエージェント向けセキュリティスキル集「Anthropic-Cybersecurity-Skills」とは に整理しています。reverse-skill との使い分けを検討する際の補足資料として併読すると、両者のスコープ差が把握しやすくなります。
7 観点での比較テーブル
観点 | reverse-skill | Anthropic-Cybersecurity-Skills | P4nda0s/reverse-skills |
|---|---|---|---|
対応領域 | 攻撃側(RE + ペネトレーションテスト + CTF)に特化 | 防御 + 攻撃の総合。29 セキュリティドメイン、6 フレームワーク準拠 | バイナリ / Android / Unity リバース中心の 8 スキル |
構造設計 | 4 層(RULES / ルーター / Ops 契約 / シナリオスキル) | フラットなスキルカタログ(YAML frontmatter + Markdown) | フラットなスキル配列 |
権限管理 |
| フレームワーク準拠(MITRE ATT&CK / NIST 等)だが、授権チェックの強制機構は明示的でない | 権限チェックの明示的な機構はなし |
ツール自動導入 |
| Python パッケージ( |
|
クライアント対応 | Claude Code / Kiro / Cursor / Cline / Codex CLI / Windsurf | Claude Code / GitHub Copilot / Codex CLI / Cursor / Gemini CLI 等 20+ プラットフォーム | Claude Code 中心(IDA-NO-MCP との併用前提) |
プラットフォーム | Windows(プライマリ)/ Kali / Ubuntu / macOS | Python 動作環境 | クライアント依存 |
サブモジュール | CTF-Sandbox-Orchestrator(GPLv3)で CTF 40+ サブスキルを併設 | なし | なし |
meirm/reverse-engineering-skill は単一の Claude スキル・小規模のため上表からは除いていますが、機能範囲を絞り込みたいケースでは選択肢になり得ます。
reverse-skill の独自性 3 点
比較テーブルから見える reverse-skill 固有の設計上の強みは、次の 3 点に集約できます。
- ルーター設計(決定論的な 1 ホップ判定): 他の 2 リポジトリが「スキルカタログ」として提供されるのに対し、reverse-skill は「タスク → RULES.md → ルーター → Ops 契約 → シナリオスキル」の判定フローを SSOT として持ち、AI エージェントが自律的に正しいスキルへ到達するよう強制します。エージェントの選定ミスや思考の遠回りを構造的に抑える設計です
- Ops 契約による安全境界:
scope-contract.md+evidence-finding-path.md+role-map.mdにより、「授権が下りるまでは対象へ ACT しない」ことを構造的に保証します。授権済みペネトレーションテスト・CTF・自社アセット対象の運用に最適化された、他 OSS にはない機構です - オンデマンドブートストラップ:
tool-index.mdを SSOT に、必要なツールのみを、必要になったときにインストールする仕組み(refresh-tool-index.ps1/.sh)を持ちます。ツールを事前に一括導入する運用と比べ、環境の重複導入や依存肥大化を避けられます
一方、Anthropic-Cybersecurity-Skills が持つ「6 フレームワーク準拠(MITRE ATT&CK / NIST CSF 2.0 / MITRE ATLAS / D3FEND / NIST AI RMF / MITRE F3)」や 20 以上のプラットフォーム対応、防御側スキルの網羅性は reverse-skill の守備範囲外です。両者は競合というより、目的別に選び分ける関係にあります。
採用判断の観点
以上の情報を踏まえ、どのようなチーム・用途に reverse-skill が適合するかを、公開ドキュメントから読み取れる範囲で整理します。
適合するケース
- 授権済みのペネトレーションテスト業務を継続的に実施している: Ops 契約層の
scope-contractによる ACT 抑制は、法的リスクを伴う対象に対する AI エージェントの暴走を防ぐガードレールとして有効です - リバースエンジニアリング・CTF・マルウェア解析を横断的に扱う: 30 以上のシナリオスキル + CTF サブモジュールにより、対象種別ごとの分断された運用を 1 つのルーターに束ねられます
- 複数の AI コーディングクライアントを併用している: Claude Code / Kiro / Cursor / Cline / Codex CLI / Windsurf のいずれにも同じルーティングルールを注入できるため、クライアントを横断してスキルを共有できます
- Windows / Kali が主要な作業環境: プライマリの PowerShell スクリプトが用意され、Kali 向けにも専用のブートストラップスクリプトが提供されています
別 OSS を検討すべきケース
- 防御中心(SOC・ブルーチーム)のセキュリティ運用: reverse-skill は攻撃側スキルに特化しているため、防御スキルを網羅したい場合は Anthropic-Cybersecurity-Skills 側が適合します
- MITRE ATT&CK / NIST CSF などのフレームワーク準拠を第一優先とする: フレームワークとの明示的なマッピングを求める場合は Anthropic-Cybersecurity-Skills が適合します
- Python 単独の動作環境で完結させたい: reverse-skill は PowerShell / Bash 前提のブートストラップ設計のため、Python パッケージ完結の運用には向きません
- バイナリ / Android / Unity の限定領域のみを扱いたい: シナリオを絞り込みたい場合は P4nda0s/reverse-skills のような領域特化型のスキル集の方がオーバーヘッドを避けられます
自チームがどこに位置するかを見極めるうえでは、「授権チェックが業務要件かどうか」「対象領域が広いか狭いか」「フレームワーク準拠が要件かどうか」の 3 つを最初に切り分けることが、選定判断のショートカットになります。
導入前に把握しておきたい注意事項
ライセンス構成の確認
reverse-skill 本体は MIT ライセンスですが、周辺コンポーネントを含めるとライセンス構成は複数階層に分かれます。
対象 | ライセンス | 備考 |
|---|---|---|
本体( | MIT | 本記事執筆時点のリポジトリ本体 |
サブモジュール | GNU GPLv3 | CTF 40+ サブスキル。組み込み・派生時は GPLv3 の条項に従う必要あり |
Pentest Swarm AI | AGPL-3.0(本家) | reverse-skill は CLI / MCP 経由で呼び出すのみで、ソース非同梱 |
呼び出し先ツール(jadx / frida / nmap / burpsuite-mcp 等) | 各公式ライセンス | 個別に条項確認が必要 |
商用利用や社内システムへの組み込みを検討する際は、サブモジュールおよび呼び出し先ツールのライセンス条項を個別に確認してください。特に GPLv3 / AGPL-3.0 のコピーレフト条項は、成果物の公開範囲・配布形態と密接に関わります。
なお、リポジトリのライセンスメタデータ上は「MIT」が主に紐付いており、gh api /repos/zhaoxuya520/reverse-skill --jq '.license.spdx_id' の値も MIT となります。ライセンスファイル自体が欠落しているわけではありません。
授権と実運用時のスコープ制御
Ops 契約層の scope-contract は「授権済みペネトレーションテスト」を強く前提としています。AI エージェントに攻撃側の操作を委ねる性質上、以下の運用ルールを社内で明文化しておくことが実務上ほぼ必須です。
- 対象アセットごとに、書面またはチケットで授権を取得し、その ID を
auth.status=grantedの根拠としてscope-contractに紐付ける network_profileで許可されたネットワーク範囲を定義し、範囲外への探査・攻撃が発生しないよう境界条件を明示する- Evidence → Finding → Path のチェーンを
evidence-finding-path.mdの運用に沿って残し、事後の再現性・監査性を担保する
これらは AI エージェントが対象へ自律的に働きかけるがゆえに必要となるガードレールで、reverse-skill を「便利なプロンプト集」として使うだけでは十分に活きません。導入時は Ops 契約層の運用フローもセットで社内合意を取ることが望ましいでしょう。
なお、公式ドキュメントは英語(README.md / README_AI.md)と中国語(README_zh.md)が主で、v1.0.0 リリース時点で日本語版は整備されていません。社内展開時はドキュメントの翻訳・要約を別途用意する必要があります。
まとめ
reverse-skill は、Claude Code / Kiro / Cursor / Cline / Codex CLI / Windsurf といった AI コーディングクライアントに、「授権済みリバース解析・ペネトレーションテスト」のオーケストレーション機構を持ち込むための AIリバース解析スキルルーターです。単一のスキルカタログではなく、RULES → ルーター → Ops 契約 → シナリオスキルの 4 層構造をとることで、判定の決定論性・安全境界・オンデマンドツール導入をひとつの設計に束ねています。
類似 OSS との比較では、Anthropic-Cybersecurity-Skills が防御 + 攻撃の総合スキル集・6 フレームワーク準拠を強みとするのに対し、reverse-skill は攻撃側(RE + ペネトレーションテスト + CTF)に絞り、Ops 契約による ACT 抑制とオンデマンドブートストラップという他にはない独自性で差別化されています。P4nda0s/reverse-skills はバイナリ / Android / Unity の領域特化型で、扱う対象が狭ければ選択肢になります。
初見エンジニアが次の一手として取れる情報探索行動は次のとおりです。
- README.md と README_AI.md を順に読み、AI クライアント側の設定注入方法を確認する
- RULES.md と skills/routing.md を通読し、自チームが扱う対象種別が Target Type マトリクスに含まれているかを確認する
- 検証環境で
refresh-tool-indexを実行し、手元にあるツールと不足しているツールを SSOT ファイル上で把握する - Ops 契約層(
scope-contract/evidence-finding-path/role-map)の運用フローが自組織のペネトレーションテスト業務フローと接続できるかを確認する
「20K スターだから採用する」ではなく、上記の観点で自チームの業務要件と突き合わせることが、reverse-skill を含む「AI エージェント向けセキュリティスキル集」の採用判断における最短経路になるはずです。
関連情報
AI エージェントを活用したセキュリティ運用・リバース解析基盤の内製化や、社内向けの技術検証・PoC の受託開発をご検討中の方は、お問い合わせフォーム からご相談ください。要件の整理段階からご相談いただけます。



