networking-diag

Diagnose iOS networking issues using Network.framework with connection state and TLS checks.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill networking-diag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: networking-diag
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/networking-diag
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill networking-diag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This diagnostic skill helps identify root causes in minutes for networking issues, focusing on connection states, TLS, proxies, and real-device conditions.

Core Features & Use Cases

  • Connection state history, TLS configuration checks, and network condition testing
  • Production-focused guidance with realistic failure scenarios
  • Best practices for diagnosing on real devices vs simulators

Quick Start

Prompt: "Diagnose a TLS handshake failure on a mobile network."

Frequently Asked Questions about networking-diag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose TLS handshake failures in iOS apps using Network.framework?

TLS handshake failures stem from certificate validation, cipher suite mismatches, or protocol version incompatibility. Network.framework diagnostics reveal the exact failure point: inspect TLS configuration, validate certificate chains, check supported ciphers, and test against varied network conditions on real devices to isolate root cause.

Why are my Network.framework connections timing out or dropping on real devices?

Connection timeouts and drops on real devices often involve network condition changes, proxy interference, or state management gaps. Systematic diagnostics track connection state history, log state transitions, validate proxy settings, and test across cellular and WiFi to pinpoint whether the issue is app-level or network-environment-driven.

How do I troubleshoot Network.framework performance issues and data not arriving?

Data arrival and performance issues require tracking connection states, inspecting TLS configuration, and validating network paths. Capture packet-level behavior, cross-validate across multiple network conditions, and compare real-device results against simulator behavior to distinguish app logic from platform or network-specific root causes.

Can I use Network.framework diagnostics to detect proxy and VPN interference?

Yes. Network.framework diagnostics include TLS configuration inspection and cross-network validation to surface proxy or VPN interference. Logging connection state history and testing across different network environments reveals when proxies intercept, modify, or block traffic.

What's the difference between diagnosing on simulators versus real devices with Network.framework?

Simulators mask real-world conditions like packet loss, latency variance, and hardware network state changes. Real-device diagnostics enforce mandatory logging, state history tracking, and cross-network validation to capture production failure scenarios that simulators cannot reproduce.

Do I need packet capture tools alongside Network.framework diagnostics?

Packet capture complements Network.framework diagnostics by revealing network-layer behavior. Diagnostics focus on connection state and TLS configuration; packet capture shows actual traffic, timing, and protocol behavior to validate findings and identify network-path or carrier-level issues.