agentsclimarketplace

Breakdown connectivity

Skill PeaceCraft-LLC/breakdown-agent-connectivity/skills/breakdown-connectivity

Connectivity diagnostics and setup for AI agents using Breakdown

Install
npx -y skills add PeaceCraft-LLC/breakdown-agent-connectivity --skill breakdown-connectivity

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Diagnose Internet, DNS, Wi-Fi, packet loss, latency, endpoint reachability, browser navigation, API, upload, download, MCP, and cloud-tool failures with Breakdown on macOS. Use when connectivity may explain a failed or flaky agent task, before long or unattended network-dependent work, after a user-visible outage, or when producing a connectivity readiness report. Also use to install Breakdown, connect its local MCP server, or discover the evidence tools it provides.

SKILL.md

4.3 KB, 772 tokens by cl100k_base, as published. Nobody here has run it

Breakdown Connectivity

Use Breakdown's local MCP server to add current and historical network evidence to an agent's own troubleshooting process. Select actions according to the task, available tools, environment capabilities, and existing user instructions.

Check for Breakdown

Look for Breakdown MCP tools such as get_current_network_health and list_recent_network_issues.

If they are available, use whichever tools fit the task. A useful starting point for many failures is current health plus recent issues, followed by evidence focused on the affected DNS resolver, Wi-Fi interface, app, endpoint, route, or time window.

Relate retained issue timestamps to the reported failure instead of assuming every listed issue is current. Prefer focused time windows and bounded result counts when detailed evidence would otherwise be large.

Read references/mcp-tools.md when choosing among Breakdown's evidence and analysis tools.

Set up Breakdown when unavailable

Breakdown requires macOS 13 or later. Its MCP bridge forwards requests to the running Breakdown app.

Use the bundled helper when shell access is available:

./scripts/setup-breakdown.sh status

The helper exposes separate operations so the calling agent can compose the setup that fits its environment:

./scripts/setup-breakdown.sh install
./scripts/setup-breakdown.sh open-app
./scripts/setup-breakdown.sh configure-codex
./scripts/setup-breakdown.sh configure-claude-code [local|project|user]
./scripts/setup-breakdown.sh print-config

status also reports whether the Mac is supported, the app is running, local MCP discovery is missing, disabled, invalid, or configured, and Codex or Claude Code already has a breakdown MCP entry.

configure-claude-code accepts an optional Claude Code MCP scope. Omit it to use Claude Code's default, or pass local, project, or user when a particular scope fits the task.

Claude Code resolves default/local and project-scoped MCP configuration from the current project directory. When using either form, resolve this helper from the skill directory while keeping the intended Claude project as the command's working directory. The Claude configuration fields in status are resolved in the same context.

install downloads the current stable package from Breakdown's official website, verifies its Developer ID Installer signature, and opens it with the standard macOS installer. An agent can instead use the official download URL or the downloaded package with other installation mechanisms available in its environment.

After installation, keep Breakdown running. Configure the client to launch:

/Applications/Breakdown/Breakdown.app/Contents/MacOS/BreakdownMCPBridge

Reload or reconnect the MCP client if that client requires it, then confirm that Breakdown's tools are discoverable.

Work with the evidence

Choose the depth that is useful for the task:

  • Inspect current segment health and freshness for a compact snapshot.
  • Review recent issues when the failure may have happened before the current moment.
  • Request time-series or route evidence around the relevant app, endpoint, resolver, interface, or time window.
  • Use Breakdown analysis when a synthesized evidence-backed investigation would help.
  • Export an Evidence Report when a portable artifact is useful.

Interpret Breakdown's structured results together with the task's other evidence. Decide subsequent actions using the agent's normal reasoning and operating instructions.

If direct setup is unavailable

Give the official download and setup information:

What ships with it: 3 files

11.9 KB alongside SKILL.md, 1 of them executable

agents/

references/

scripts/

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.