
Packet Capture Analysis
- 9 installs
- 23 repo stars
- Updated August 4, 2026
- aktsmm/agent-skills
packet-capture-analysis is a Claude skill that analyzes pcap/pcapng files, labels IPs with evidence, generates PNG charts and writes packet-analysis reports.
About
Reads pcap and pcapng files to build an overall picture, label IPs with evidence, generate PNG charts and write Markdown reports. A developer uses it to triage network captures with tshark, capinfos, scapy and matplotlib, starting with a fixed protocol-hierarchy, endpoints and conversations pass, then labeling top talkers via DNS, HTTP Host, TLS SNI and RDAP. It keeps evidence sources separate and describes encrypted traffic by behavior rather than payload.
- Triages pcap/pcapng with tshark, capinfos, scapy and matplotlib
- Evidence-based IP labeling via DNS, HTTP Host, TLS SNI, RDAP and reverse DNS
- Produces at least a time-series PNG and a ranking PNG plus a Markdown report
Packet Capture Analysis by the numbers
- 9 all-time installs (skills.sh)
- Ranked #1,020 of 1,435 DevOps & CI/CD skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
packet-capture-analysis capabilities & compatibility
Free; requires Wireshark CLI tools and Python plotting libraries
- Capabilities
- azure troubleshooting · network forensics · data analysis
- Use cases
- debugging · data analysis · security audit
- Pricing
- Free
What packet-capture-analysis says it does
pcap / pcapng を読んで、全体像の把握、IP の意味付け、PNG 可視化、Markdown レポート化まで進めるための skill。
**最初の 3 手は固定**。`Protocol Hierarchy` → `Endpoints` → `Conversations` で全体像を作る。
npx skills add https://github.com/aktsmm/agent-skills --skill packet-capture-analysisAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 9 |
|---|---|
| repo stars | ★ 23 |
| Last updated | August 4, 2026 |
| Repository | aktsmm/agent-skills ↗ |
What it does
Triage a pcap capture, label top talkers with evidence, and produce charts and a Markdown report.
Who is it for?
Triaging network captures, evidence-based IP labeling, and producing charts and reports from pcap files
Skip if: Concluding an incident from Expert Information alone or mass-querying every IP externally
When should I use this skill?
Analyzing a pcap/pcapng, identifying top talkers, or writing a packet-analysis report
What you get
A pcap triage with evidence-labeled top talkers, at least two PNG charts and a Markdown report
- Top talkers and conversations tables
- Evidence-labeled IPs
- Time-series and ranking PNG charts
By the numbers
- 6-step default workflow
- minimum 2 PNG charts (time-series + ranking)
Files
Packet Capture Analysis
pcap / pcapng を読んで、全体像の把握、IP の意味付け、PNG 可視化、Markdown レポート化まで進めるための skill。
When To Use
pcapやpcapngを渡されて、まず何が起きているか把握したいとき- 主要通信先、主要会話、プロトコル構成を短時間で掴みたいとき
- DNS、HTTP Host、TLS SNI、RDAP を使って IP に根拠付きラベルを付けたいとき
- PNG グラフや Markdown レポートまで一緒に作りたいとき
- 暗号化通信が多く、本文ではなく行動特性から説明したいとき
- セキュリティ調査と運用調査のどちらにも使いたいとき
Core Principles
- まずキャプチャ品質を見る。snaplen、時系列、件数、期間に問題があれば結論の強さを下げる。
- 最初の 3 手は固定。
Protocol Hierarchy→Endpoints→Conversationsで全体像を作る。 - IP は生のまま並べない。
HTTP Host -> DNS 応答 -> TLS SNI / gQUIC SNI -> RDAP -> reverse DNSの順で意味付けする。 - 証拠源は混ぜない。
hostnameとorganizationのような別種の根拠は分けて持つ。 - Expert Information は入口であって結論ではない。前後の会話量、方向、再送、再組立てを見直す。
- 暗号化通信は本文ではなく行動特性で説明する。相手先、方向、量、時間帯、継続時間で語る。
- 一次集計は CLI、派生集計は Python。
capinfos/tsharkで切ってからscapy/matplotlibへ渡す。
Default Workflow
1. 調査目的を固定する
- 何を知りたいのかを先に決める。
- 例: 大容量通信の相手、怪しい外部送信、特定アプリ通信、レポート化。
2. キャプチャ品質を確認する
- 期間、件数、平均レート、時系列、snaplen、
pcapngの名前解決情報を確認する。 - 品質に問題があるなら、その後の結論は「傾向把握寄り」に落とす。
3. 全体像を作る
Protocol Hierarchy/Endpoints/Conversationsでベースラインを作る。- ここでは細部に潜りすぎず、支配的プロトコル、主要通信先、主要会話を押さえる。
4. 主要通信先を意味付けする
- 上位 N 件の通信先から順にラベル付けする。
- 全件一括照会は避け、報告対象候補だけを調べる。
- 根拠が弱いものは
Unknownのまま残す。
5. 行動特性と異常候補を整理する
- HTTP が見えるなら path / host / 方向 / 応答量を見る。
- TLS / QUIC しか見えないなら、相手先、量、時間帯、継続時間で説明する。
- 異常候補は
確認できたこと / 要再確認 / 未解決で整理する。
6. 可視化とレポート化を行う
- 最低限、時系列 1 枚とランキング 1 枚を出す。
- グラフには対象期間、集計単位、フィルタ条件、top N 基準を書く。
- レポートは、要約 → 主要表/グラフ → 所見 → 未解決点 の順にまとめる。
Tool Choice
CLI を優先する場面
- 初動トリアージ
- 大きいキャプチャの一次集計
Protocol Hierarchy/Endpoints/Conversations- DNS / HTTP / TLS 情報の抽出
Python を優先する場面
- CLI 結果の二次加工
- 独自ランキングやラベル付け
- PNG 生成
- Markdown レポート化
描画の選び方
- Python 内で完結したいなら
matplotlib - 軽量 CLI で描きたいなら
gnuplot
Minimum Outputs
- 短い要約
- 上位通信先表
- 上位会話表
- 根拠付き IP ラベル
- 少なくとも 2 枚の PNG
- 時間推移系 1 枚
- ランキング系 1 枚
確認できたこと / 要再確認 / 未解決の整理
Anti-Patterns
- Expert Information だけで障害確定する
- 全 IP を無差別に外部照会する
- 所有者情報をサービス名と同一視する
- 暗号化通信を無理に本文ベースで説明しようとする
- グラフに期間、集計単位、フィルタ条件を書かない
- 大きいキャプチャを最初から Python で全件読込する
Completion Checks
- キャプチャ品質確認が済んでいる
- 主要プロトコル、主要通信先、主要会話を説明できる
- 上位 IP または上位会話に、根拠付きラベルが付いている
- 少なくとも 1 枚の時間推移 PNG と 1 枚のランキング PNG がある
- 異常候補が
確認できたこと / 要再確認 / 未解決に整理されている - レポートに、グラフ条件とラベル付け方針が書かれている
- 暗号化通信でも行動特性ベースの説明ができている
4. extract_tshark_stats.py
tsharkとcapinfosの標準統計を TSV / JSON / text に落とす専用スクリプト
スクリプト設計の原則
- 1 本で全部やる総合版と、補助用途の小さいスクリプトを分ける
- 解析ロジックと描画ロジックを分離できるようにする
- ラベルの証拠源を別フィールドで保持する
- 出力先ディレクトリを引数で変えられるようにする
- レポート生成をオフにして、表や PNG だけ出せるモードを持たせると再利用しやすい
Notes
- IP ラベル付けは、読みやすさを大きく改善します。
- ただし、所有者情報と実サービス名は同じではないため、根拠源を分けて扱います。
- Expert Information は開始点としては有効ですが、単独で結論にはしません。
- 暗号化通信は本文よりも行動特性で説明した方が安全です。
- 日本語版レポートは便利ですが、標準必須ではなく、必要に応じて追加出力とします。
References
- Wireshark
tsharkmanual: https://www.wireshark.org/docs/man-pages/tshark.html - Wireshark
capinfosmanual: https://www.wireshark.org/docs/man-pages/capinfos.html - Wireshark User's Guide: Conversations
https://www.wireshark.org/docs/wsug_html_chunked/ChStatConversations.html
- Wireshark User's Guide: Endpoints
https://www.wireshark.org/docs/wsug_html_chunked/ChStatEndpoints.html
- Wireshark User's Guide: Protocol Hierarchy
https://www.wireshark.org/docs/wsug_html_chunked/ChStatHierarchy.html
- Wireshark User's Guide: I/O Graphs
https://www.wireshark.org/docs/wsug_html_chunked/ChStatIOGraphs.html
- Wireshark User's Guide: Expert Information
https://www.wireshark.org/docs/wsug_html_chunked/ChAdvExpert.html
- Wireshark User's Guide: Name Resolution
https://www.wireshark.org/docs/wsug_html_chunked/ChAdvNameResolutionSection.html
- Wireshark User's Guide: Resolved Addresses
https://www.wireshark.org/docs/wsug_html_chunked/ChStatResolvedAddresses.html
- Scapy Usage Guide
https://scapy.readthedocs.io/en/latest/usage.html
- RFC 7482: RDAP Query Format
https://datatracker.ietf.org/doc/html/rfc7482
- ICANN RDAP Overview
https://www.icann.org/rdap/
- ARIN Whois / RDAP Guide
https://www.arin.net/resources/registry/whois/rdap/
# Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
## English
Copyright (c) 2025-2026 yamapan (aktsmm)
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License.
You are free to:
- **Share** — copy and redistribute the material in any medium or format
- **Adapt** — remix, transform, and build upon the material
Under the following terms:
- **Attribution** — You must give appropriate credit, provide a link to the
license, and indicate if changes were made. You may do so in any reasonable manner,
but not in any way that suggests the licensor endorses you or your use.
- **NonCommercial** — You may not use the material for commercial purposes.
*(Please contact the author if you wish to use this material for commercial purposes.)*
- **ShareAlike** — If you remix, transform, or build upon the material, you must
distribute your contributions under the same license as the original.
No additional restrictions — You may not apply legal terms or technological
measures that legally restrict others from doing anything the license permits.
**AI/ML Training Restriction** — Use of this content for AI/ML training, data
mining, or other analytical purposes is prohibited without explicit permission.
Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
---
## 日本語
Copyright (c) 2025-2026 yamapan (aktsmm)
この作品はクリエイティブ・コモンズ 表示-非営利-継承 4.0 国際ライセンスの下に提供されています。
あなたは以下の条件に従う限り、自由に:
- **共有** — どのようなメディアやフォーマットでも資料を複製・再配布できます
- **翻案** — 資料をリミックス、変形、および加工することができます
以下の条件に従ってください:
- **表示** — あなたは適切なクレジットを表示し、ライセンスへのリンクを提供し、
変更があったらその旨を示さなければなりません。これらは合理的であればどのような方法で
行っても構いませんが、許諾者があなたやあなたの利用行為を支持していると示唆するような
方法は除きます。
- **非営利** — あなたは営利目的でこの資料を利用してはなりません。
(※商用利用をご希望の場合は、別途ご連絡ください。)
- **継承** — もしあなたがこの資料をリミックス、変形、または加工した場合、
あなたはあなたの貢献部分を元の作品と同じライセンスの下で配布しなければなりません。
追加的な制約は課せません — あなたは、このライセンスが他の者に許諾することを法的に
制限するような法的条項や技術的手段を適用してはなりません。
**AI/MLトレーニング制限** — 本コンテンツをAI/MLモデルのトレーニング、データマイニング、
その他の解析目的での使用は明示的な許可なく禁止されています。
ライセンス全文: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ja
---
## Special Permission for Microsoft Employees / Microsoft 社員向け特別許諾
### English
Microsoft Corporation employees are granted permission to use, copy, modify, and
distribute this material for any purpose within the scope of their employment
duties at Microsoft, including internal business use and customer-facing
activities, without the NonCommercial restriction of this license.
This special permission applies only to work performed as part of official
Microsoft business activities.
### 日本語
Microsoft Corporation の社員は、Microsoft での業務の範疇において、本資料を社内業務
および顧客対応を含むあらゆる目的で使用、複製、改変、配布することが許諾されます。
この場合、本ライセンスの「非営利」制限は適用されません。
この特別許諾は、Microsoft の公式な業務活動の一環として行われる作業にのみ適用されます。
---
## Disclaimer / 免責事項
### English
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR
A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
### 日本語
本ソフトウェアは「現状のまま」で提供され、明示または黙示を問わず、商品性、
特定目的への適合性、および権利非侵害についての保証を含むがこれに限定されない、
いかなる種類の保証も伴いません。作者または著作権者は、契約行為、不法行為、
またはそれ以外であろうと、ソフトウェアに起因または関連し、あるいはソフトウェアの
使用またはその他の扱いによって生じる一切の請求、損害、その他の責任について
責任を負いません。Related skills
FAQ
What is the first pass?
A fixed three-step baseline: Protocol Hierarchy, then Endpoints, then Conversations, before diving into details.
How are IPs labeled?
In order HTTP Host, DNS response, TLS/gQUIC SNI, RDAP, then reverse DNS, keeping hostname and organization evidence in separate fields.