aiskillstore/marketplace / skills/abdelstark/p2p-networking
p2p-networking
VerifiedPeer-to-peer networking patterns using commonware for building decentralized Guts network
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| skill-report.json | config | 23.7 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-07T18:03:18.341Z",
"slug": "abdelstark-p2p-networking",
"source_url": "https://github.com/AbdelStark/guts/tree/main/.claude/skills/p2p-networking",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "a2169e5c01071de540332639e5d126731e712c921e6ee46ee23f188f8a75c918",
"tree_hash": "c4b7cbfb350464f926731c130f13510fb4dd67c80233b6a0b31a1670d3fbe1a7",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "p2p-networking",
"description": "Guides Rust peer-to-peer networking patterns for decentralized code collaboration using commonware concepts.",
"summary": "Rust-focused P2P networking guidance for message design, peer management, gossip, repository sync, and secure configuration.",
"icon": "📦",
"version": "1.0.1",
"author": "AbdelStark",
"license": "MIT",
"tags": [
"p2p",
"rust",
"networking",
"gossip-protocol",
"decentralized"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands",
"network"
],
"category": "coding"
},
"security_audit": {
"risk_level": "medium",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Most static findings are false positives caused by Markdown backticks, code fences, and Rust protocol examples. The audit confirms one network exposure risk from binding to 0.0.0.0 and one semantic concern where gossip data is processed before validation is shown.",
"remediation": [
{
"issue": "Default listener binds to all interfaces.",
"suggestion": "Use 127.0.0.1 for local examples, or clearly warn users before binding production nodes to 0.0.0.0.",
"severity": "medium"
},
{
"issue": "Gossip handler omits validation before processing peer data.",
"suggestion": "Add explicit size, schema, topic, signature, and rate checks before process_message and rebroadcast steps.",
"severity": "medium"
}
],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 12,
"line_end": 12
},
{
"file": "SKILL.md",
"line_start": 16,
"line_end": 36
},
{
"file": "SKILL.md",
"line_start": 36,
"line_end": 40
},
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 68
},
{
"file": "SKILL.md",
"line_start": 68,
"line_end": 72
},
{
"file": "SKILL.md",
"line_start": 72,
"line_end": 125
},
{
"file": "SKILL.md",
"line_start": 125,
"line_end": 129
},
{
"file": "SKILL.md",
"line_start": 129,
"line_end": 174
},
{
"file": "SKILL.md",
"line_start": 174,
"line_end": 178
},
{
"file": "SKILL.md",
"line_start": 178,
"line_end": 218
},
{
"file": "SKILL.md",
"line_start": 218,
"line_end": 222
},
{
"file": "SKILL.md",
"line_start": 222,
"line_end": 255
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "SKILL.md",
"line_start": 246,
"line_end": 246
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 12,
"line_end": 12,
"snippet": "The `commonware-p2p` crate provides authenticated, encrypted peer communication."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 16,
"line_end": 36,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 36,
"line_end": 40,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 68,
"snippet": "```rust"
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 68,
"line_end": 72,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 72,
"line_end": 125,
"snippet": "```rust"
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 125,
"line_end": 129,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 129,
"line_end": 174,
"snippet": "```rust"
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 174,
"line_end": 178,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 178,
"line_end": 218,
"snippet": "```rust"
},
{
"id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 218,
"line_end": 222,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:222:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 222,
"line_end": 255,
"snippet": "```rust"
},
{
"id": "network:SKILL.md:246:hardcoded-ip-address",
"category": "network",
"severity": "medium",
"pattern": "Hardcoded IP address",
"file": "SKILL.md",
"line_start": 246,
"line_end": 246,
"snippet": "listen_addr: \"0.0.0.0:9000\".parse().unwrap(),"
},
{
"id": "sensitive:SKILL.md:95:certificate-key-files",
"category": "sensitive",
"severity": "high",
"pattern": "Certificate/key files",
"file": "SKILL.md",
"line_start": 95,
"line_end": 95,
"snippet": "let connection = Connection::connect(addr, &self.config.keypair).await?;"
},
{
"id": "blocker:SKILL.md:101:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 101,
"line_end": 101,
"snippet": "let peer_id = peer_info.id.clone();"
},
{
"id": "blocker:SKILL.md:140:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 140,
"line_end": 140,
"snippet": "let message_id = MessageId::from_content(&topic, &data);"
},
{
"id": "blocker:SKILL.md:163:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 163,
"line_end": 163,
"snippet": "let message_id = MessageId::from_content(&topic, &data);"
},
{
"id": "obfuscation:SKILL.md:1:heuristic-multiple-bracket-chains-6-jsfuck-obfus",
"category": "obfuscation",
"severity": "high",
"pattern": "[HEURISTIC] Multiple bracket chains (6) - JSFuck/obfuscation pattern",
"file": "SKILL.md",
"line_start": 1,
"line_end": 1,
"snippet": "())), (()), (())"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:12:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text is inline Markdown around the crate name commonware-p2p. It is not Ruby, shell execution, or an executable command."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text opens a fenced Markdown diagram. It documents network architecture and does not execute commands."
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text closes a fenced Markdown diagram. It is documentation syntax, not shell or Ruby execution."
},
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text opens a Rust code fence for message type examples. It contains sample Rust declarations, not command execution."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text closes a Rust code fence. It is Markdown formatting and cannot execute commands."
},
{
"id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text opens a Rust code fence for peer management examples. The surrounding content is illustrative Rust, not shell execution."
},
{
"id": "external_commands:SKILL.md:125:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text closes a Rust code fence. It is Markdown syntax, not an executable backtick operator."
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text opens a Rust code fence for gossip protocol examples. No command invocation or shell interpolation is present."
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text closes a Rust code fence. It is inert Markdown documentation syntax."
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text opens a Rust code fence for repository synchronization examples. It does not contain shell commands or Ruby backtick execution."
},
{
"id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The matched text closes a Rust code fence. It is not executable content."
},
{
"id": "external_commands:SKILL.md:222:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The matched text opens a Rust code fence for network configuration examples. It is documentation formatting and not command execution."
},
{
"id": "network:SKILL.md:246:hardcoded-ip-address",
"verdict": "confirmed",
"confidence": 0.78,
"reason": "The default configuration binds to 0.0.0.0:9000, which exposes the service on all network interfaces if copied into a real node. It is an example, but the broad bind is a genuine network exposure risk.",
"severity": "medium"
},
{
"id": "sensitive:SKILL.md:95:certificate-key-files",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The line passes an existing keypair into a connection setup call for peer authentication. It does not reference certificate files, hardcoded private keys, or secret exfiltration."
},
{
"id": "blocker:SKILL.md:101:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line clones a peer identifier returned by a handshake and stores peer state. It is normal P2P bookkeeping, not host or network reconnaissance."
},
{
"id": "blocker:SKILL.md:140:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line derives a message ID from gossip topic and data for deduplication. It does not inspect system configuration, enumerate hosts, or collect environment data."
},
{
"id": "blocker:SKILL.md:163:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The line derives a message ID from received gossip data to prevent rebroadcast loops. That is protocol bookkeeping, not system reconnaissance."
},
{
"id": "obfuscation:SKILL.md:1:heuristic-multiple-bracket-chains-6-jsfuck-obfus",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The file is Markdown with YAML front matter, diagrams, and Rust examples. No JavaScript, encoded payload, or instruction hiding pattern is present."
}
],
"semantic_findings": [
{
"title": "Gossip Message Validation Missing",
"description": "The gossip handler processes and rebroadcasts received data without showing validation before process_message is called.",
"severity": "medium",
"locations": [
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 168
}
],
"confidence": 0.66,
"confidence_reasoning": "The example later recommends message validation, but the handler snippet does not enforce it before processing peer data. This is a content-level security gap, not evidence of malicious intent."
}
],
"critical_findings": [],
"high_findings": [],
"medium_findings": [
{
"title": "Hardcoded IP address",
"description": "listen_addr: \"0.0.0.0:9000\".parse().unwrap(),",
"locations": [
{
"file": "SKILL.md",
"line_start": 246,
"line_end": 246
}
],
"review_kind": "capability",
"source_category": "network",
"source_severity": "medium",
"confidence": 0.78,
"confidence_reasoning": "The default configuration binds to 0.0.0.0:9000, which exposes the service on all network interfaces if copied into a real node. It is an example, but the broad bind is a genuine network exposure risk."
},
{
"title": "Gossip Message Validation Missing",
"description": "The gossip handler processes and rebroadcasts received data without showing validation before process_message is called.",
"locations": [
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 168
}
],
"review_kind": "security",
"source_category": "semantic",
"source_severity": "medium",
"confidence": 0.66,
"confidence_reasoning": "The example later recommends message validation, but the handler snippet does not enforce it before processing peer data. This is a content-level security gap, not evidence of malicious intent."
}
],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 264,
"audit_model": "codex",
"audited_at": "2026-07-07T18:03:18.341Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Build P2P Networking Patterns",
"value_statement": "Decentralized code collaboration needs clear peer communication patterns. This skill helps Claude, Codex, and Claude Code draft Rust P2P designs with commonware concepts.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"p2p networking",
"Rust networking",
"commonware p2p",
"gossip protocol",
"repository synchronization",
"decentralized collaboration",
"peer discovery"
],
"actual_capabilities": [
"Explains a Rust message enum for peer handshakes, repository sync, gossip, and keep-alive traffic.",
"Shows peer manager structure with connection setup, peer state, and broadcast flow.",
"Outlines gossip deduplication, fanout selection, message processing, and rebroadcast behavior.",
"Describes repository synchronization through refs, missing object detection, fetching, and local storage.",
"Defines network configuration fields for listen address, bootstrap nodes, limits, timeouts, and keypairs.",
"Lists security considerations for authentication, encryption, rate limiting, peer scoring, and validation."
],
"limitations": [
"Examples are Rust-oriented and depend on types that are not fully defined in the skill.",
"The skill does not provide a complete runnable P2P node implementation.",
"Bootstrap discovery, DHT behavior, and NAT traversal are only described at a high level.",
"Production hardening requires additional validation, monitoring, abuse controls, and deployment review."
],
"use_cases": [
{
"title": "Design a P2P Protocol",
"description": "Plan message types, handshake flow, gossip topics, and repository sync behavior for a decentralized collaboration tool.",
"target_user": "Protocol engineer"
},
{
"title": "Draft Rust Networking Components",
"description": "Use the examples as structure for peer managers, connection state, broadcast paths, and configuration models.",
"target_user": "Rust backend developer"
},
{
"title": "Review Network Security Requirements",
"description": "Identify authentication, encryption, rate limiting, validation, and peer scoring controls needed before production use.",
"target_user": "Security reviewer"
}
],
"prompt_templates": [
{
"title": "Explain the Architecture",
"scenario": "Beginner orientation",
"prompt": "Explain how this P2P networking skill organizes peers, messages, gossip, repository sync, and security controls."
},
{
"title": "Plan Message Types",
"scenario": "Protocol design",
"prompt": "Help me design message types for a Rust P2P repository sync protocol using the patterns in this skill."
},
{
"title": "Harden Gossip Handling",
"scenario": "Security improvement",
"prompt": "Review my gossip handling design and suggest validation, rate limiting, deduplication, and peer scoring controls."
},
{
"title": "Assess Production Readiness",
"scenario": "Advanced audit",
"prompt": "Compare my P2P node design against this skill and identify gaps in discovery, authentication, configuration, and abuse resistance."
}
],
"output_examples": [
{
"input": "Explain the role of the peer manager.",
"output": "A peer manager tracks connected peers, stores their capabilities, opens authenticated connections, and broadcasts messages across active connections."
},
{
"input": "Review my gossip protocol for safety.",
"output": [
"Validate message size and topic before processing.",
"Deduplicate messages before rebroadcasting.",
"Apply per-peer rate limits and update peer scores after abuse."
]
},
{
"input": "Plan repository sync between peers.",
"output": "The sync flow should discover peers with the repository, compare refs, request missing objects, verify objects, and store validated data locally."
}
],
"best_practices": [
"Treat the snippets as architecture guidance and add production checks before deployment.",
"Use explicit validation for every message received from a peer.",
"Document network binding, bootstrap node, key management, and rate limit choices."
],
"anti_patterns": [
"Binding public listeners by default without an operator warning.",
"Processing gossip payloads before validation and abuse checks.",
"Copying sample types directly without defining trust boundaries and failure behavior."
],
"faq": [
{
"question": "What programming language does this skill target?",
"answer": "It targets Rust and uses commonware-style P2P networking concepts."
},
{
"question": "Does this skill create a complete P2P node?",
"answer": "No. It provides patterns and examples that need integration, testing, and hardening."
},
{
"question": "Can I use it with Claude Code or Codex?",
"answer": "Yes. The report lists support for Claude, Codex, and Claude Code."
},
{
"question": "What security topics does it cover?",
"answer": "It covers authentication, encryption, rate limiting, peer scoring, and message validation at a planning level."
},
{
"question": "Is the default network address production ready?",
"answer": "No. Review any 0.0.0.0 listener before deployment because it exposes the service on all interfaces."
},
{
"question": "What should I add before using the examples?",
"answer": "Add complete validation, error handling, tests, abuse controls, observability, and deployment-specific configuration."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 264
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |