Agent skill

Operate Network Recon

by cyberful in cyberful/cyberful

Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up.

AGPL-3.0Auto-check passedSecurity

Install Operate Network Recon

skills CLI
$ npx skills add cyberful/cyberful --skill operate-network-recon -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cyberful/cyberful operate-network-recon --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cyberful/cyberful.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cyberful/builtin/skills/operate-network-recon .claude/skills/operate-network-recon && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
operate-network-recon
GitHub stars
135
Token cost
~1.1k tokens
SKILL.md length
437 words
Files
9 (incl. scripts, references, assets)
Skills in repo
85
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up.

  • Works in 7 steps: Route and name: DNS records, reverse… → Reachability: multiple host discovery… → Port inventory: full or justified range… → …
  • Authorized external
  • SKILL.md covers Establish the scan contract, Layer discovery, Use Nmap output as evidence and Reconcile scanners, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Operate Network Recon is an agent skill from cyberful/cyberful. Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up. Use for authorized external or internal reconnaissance, service fingerprinting, exposure validation, segmentation checks, UDP discovery, TLS/SNI routing, scan reconciliation, or when an existing port list may be incomplete or misleading.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `assets/network-recon-campaign.example.json` and `assets/network-recon-campaign.schema.json`).

It sits in Security, covering Penetration testing, Bug bounty and Accounting and bookkeeping. It works with Nmap. The repository describes itself as: Cyberful is an open-source AI Red Team for discovering, exploiting, verifying, and remediating vulnerabilities. The licence is AGPL-3.0.

When your agent uses it

  • Authorized external
  • Internal reconnaissance
  • Service fingerprinting
  • Exposure validation

Example prompts

  • “/operate-network-recon”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Route and name: DNS records, reverse DNS, ASN/network ownership, local routes, proxy/VPN path.
  2. Reachability: multiple host discovery probes or -Pn when filtering makes ICMP conclusions unreliable.
  3. Port inventory: full or justified range with explicit timing/rate.
  4. Service identity: targeted -sV on discovered ports with adequate version intensity.
  5. Protocol confirmation: native client or NSE script selected for that protocol.
  6. Application routing: SNI, Host, protocol upgrade, realm, tenant, or virtual-service distinctions.
  7. Security checks: narrow scripts or manual probes driven by confirmed service features.

What it can do on your machine

Read from SKILL.md and the folder at commit ec598a6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Operate Network Recon loads about 1.1k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 97 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from cyberful/cyberful at commit ec598a6, republished under its AGPL-3.0 licence (© cyberful). 437 words, ~1,139 tokens.

Download SKILL.mdSave it as .claude/skills/operate-network-recon/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
operate-network-recon
description
Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up. Use for authorized external or internal reconnaissance, service fingerprinting, exposure validation, segmentation checks, UDP discovery, TLS/SNI routing, scan reconciliation, or when an existing port list may be incomplete or misleading.
metadata.domain
security-tooling
metadata.subdomain
network-reconnaissance
metadata.triggers
authorized network reconnaissance, network service inventory, Nmap campaign, service fingerprinting, port exposure validation
metadata.tags
Nmap, network-recon, service-discovery, port-scanning, DNS, packet-capture

Operate Network Recon

Separate host reachability, port state, service identity, application identity, and vulnerability hypotheses. Each requires different evidence.

Establish the scan contract

Record target set, exclusions, vantage point, address family, DNS resolution time, allowed rates, maintenance constraints, credential availability, expected intermediaries, and whether UDP or non-default protocols are required.

Create a target ledger before scanning. Expand CIDRs and hostnames deliberately; preserve original hostname-to-address mappings and do not silently merge multiple virtual services behind one IP.

Layer discovery

  1. Route and name: DNS records, reverse DNS, ASN/network ownership, local routes, proxy/VPN path.
  2. Reachability: multiple host discovery probes or -Pn when filtering makes ICMP conclusions unreliable.
  3. Port inventory: full or justified range with explicit timing/rate.
  4. Service identity: targeted -sV on discovered ports with adequate version intensity.
  5. Protocol confirmation: native client or NSE script selected for that protocol.
  6. Application routing: SNI, Host, protocol upgrade, realm, tenant, or virtual-service distinctions.
  7. Security checks: narrow scripts or manual probes driven by confirmed service features.

Read references/service-fingerprint-fieldbook.md for false-negative and cross-protocol heuristics.

Use Nmap output as evidence

Always persist normal, XML, and grepable outputs when practical. Include exact target input, command, Nmap version, timestamps, elapsed time, and scan conditions. Prefer XML for machine correlation.

Treat states precisely:

  • open: a service accepted/responded;
  • closed: target reachable and rejected at that instant;
  • filtered: probes lacked a decisive response;
  • open|filtered: common UDP ambiguity;
  • unfiltered: reachable but open/closed unresolved.

Do not translate filtered into closed or host down.

Show full SKILL.md (194 more words)Show less

Reconcile scanners

Masscan is a fast candidate generator; Nmap and protocol clients are validators. Differences can arise from rate, retries, source port, SYN proxying, load balancing, ephemeral services, tarpits, anycast, or per-source policy.

For every material discrepancy:

  1. rescan serially from the same vantage;
  2. capture packets if possible;
  3. vary only one transport assumption;
  4. validate with the native protocol;
  5. timestamp the conclusion.

For a repeatable active campaign, stage scripts/run_network_recon_campaign.py, scripts/manifest.json, and the campaign example. Fill the explicit authority contract before execution. The orchestrator constructs fixed Nmap argv, rejects hosts or ports outside that contract, enforces request and timeout bounds, and preserves raw stdout/stderr under the evidence schema. It does not classify a service or vulnerability.

Select scripts narrowly

Choose NSE categories/scripts from a concrete hypothesis. Inspect script arguments and source for authentication, broadcast behavior, brute force, intrusive actions, or dependency assumptions. Prefer explicit script names over broad categories, and preserve script output separately from version detection.

Handoff

Produce:

  • live/unknown host ledger;
  • port/service/application matrix;
  • hostname/SNI/vhost mappings;
  • protocol features and authentication surfaces;
  • conflicting or unstable observations;
  • coverage gaps by address family, transport, port range, and vantage;
  • prioritized hypotheses with the exact next discriminator.

© cyberful, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts, references, assets) in cyberful/builtin/skills/operate-network-recon of cyberful/cyberful.

  • SKILL.md
  • agents/openai.yaml
  • assets/network-recon-campaign.example.json
  • assets/network-recon-campaign.schema.json
  • assets/network-recon-evidence.schema.json
  • references/service-fingerprint-fieldbook.md
  • scripts/manifest.json
  • scripts/run_network_recon_campaign.py
  • tests/test_run_network_recon_campaign.py

Open the folder on GitHubat commit ec598a6

Compare with similar skills

Operate Network Recon next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Operate Network Recon compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Operate Network Recon this skillcyberful/cyberful135—~1.1kAutomated safety check: PassAGPL-3.0
Nmap ReconCommonHuman-Lab/nyxstrike157—~639Automated safety check: PassCustom licence
Add Partial Reconsamugit83/redamon3k—~1.1kAutomated safety check: PassMIT
NmapBrownFineSecurity/iothackbot8591 repos~3.8kAutomated safety check: NotesMIT
Systematic Attackingmtarcure/claude-vibe-squad165—~3.6kAutomated safety check: PassMIT
Project Settings Cascadesamugit83/redamon3k—~2.4kAutomated safety check: PassMIT

Similar skills

  • Nmap Recon

    CommonHuman-Lab/nyxstrike

    Network reconnaissance workflow using nmap, masscan, and rustscan via NyxStrike tools

    157 GitHub stars~639 tokensUpdated yesterday
    SecurityAuto-check passed
  • Add Partial Recon

    samugit83/redamon

    Adding partial-recon support for a tool: running a single pipeline phase on demand from the workflow graph, reading its inputs from the existing Neo4j graph and merging results back.

    3k GitHub stars~1.1k tokensUpdated 2 days ago
    SecurityAuto-check passed
  • Nmap

    BrownFineSecurity/iothackbot

    Professional network reconnaissance and port scanning using nmap.

    859 GitHub starsUsed in 1 repo~3.8k tokens
    SecurityAuto-check: notes
  • Systematic Attacking

    mtarcure/claude-vibe-squad

    A skill your agent uses for ALL authorized offensive-security / bug-bounty work — the single method to find, chain, prove, dedup, and package the highest-value (High/Critical) findings across every…

    165 GitHub stars~3.6k tokensUpdated 19 days ago
    SecurityAuto-check passed
  • Project Settings Cascade

    samugit83/redamon

    Changing or adding a project setting / default value in RedAmon.

    3k GitHub stars~2.4k tokensUpdated 2 days ago
    SecurityAuto-check passed
  • Web Recon

    CommonHuman-Lab/nyxstrike

    Web content discovery and technology fingerprinting using gobuster, ffuf, feroxbuster, katana, httpx, and wafw00f

    157 GitHub stars~907 tokensUpdated yesterday
    SecurityAuto-check passed

More from cyberful/cyberful

All 85 skills in this repo
  • Audit infrastructure-as-code artifacts for unsafe defaults, policy gaps, privilege exposure, control drift, and deployment-impact evidence.

    135 GitHub stars~649 tokensUpdated 1 mo ago
    Auto-check passed
  • Audit Kubernetes admission and policy-as-code enforcement against local workload manifests, exception paths, namespace scope, and deployment evidence.

    135 GitHub stars~610 tokensUpdated 1 mo ago
    Auto-check passed
  • Audit PCI DSS penetration-test methodology, scope, internal and external reports, segmentation results, tester independence, remediation, retesting, retention, and multi-tenant support evidence.

    135 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Content Discovery

    cyberful/cyberful

    Design and interpret advanced content discovery with ffuf and complementary web fuzzers.

    135 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Sast Toolchain

    cyberful/cyberful

    Operate Semgrep and source-oriented static analysis as a hypothesis, coverage, and regression system during advanced code audits.

    135 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Operate Syft, Grype, Trivy, Gitleaks, Retire.js, package-manager metadata, and build evidence for advanced software-supply-chain assessment.

    135 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Operate Network Recon

What does Operate Network Recon do?

Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up. Operate Network Recon is an agent skill from cyberful/cyberful. Build a high-fidelity network and service inventory using Nmap, Masscan, packet capture, DNS, and protocol-specific follow-up.

When should I use Operate Network Recon?

Operate Network Recon fits situations like: authorized external; internal reconnaissance; service fingerprinting; exposure validation.

How do I install Operate Network Recon in Claude Code?

Run `npx skills add cyberful/cyberful --skill operate-network-recon -a claude-code`. Or copy the skill folder (cyberful/builtin/skills/operate-network-recon in cyberful/cyberful) into .claude/skills/operate-network-recon in your project. Claude Code loads it when a task matches its description.

How do I install Operate Network Recon in Codex?

Run `npx skills add cyberful/cyberful --skill operate-network-recon -a codex`. Or copy the skill folder (cyberful/builtin/skills/operate-network-recon in cyberful/cyberful) into .agents/skills/operate-network-recon in your project. Codex loads it when a task matches its description.

Can I use Operate Network Recon in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cyberful/cyberful --skill operate-network-recon -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/operate-network-recon, .gemini/skills/operate-network-recon, .github/skills/operate-network-recon and .opencode/skills/operate-network-recon in your project.

What does Operate Network Recon need to run?

Going by SKILL.md and its folder, Operate Network Recon needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Operate Network Recon access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Operate Network Recon safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Operate Network Recon use?

Operate Network Recon is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Operate Network Recon use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 874 tokens, read only when the agent opens those files.

What are the alternatives to Operate Network Recon?

Skills that share tags, products or a category with Operate Network Recon: Nmap Recon (CommonHuman-Lab/nyxstrike, 157 stars), Add Partial Recon (samugit83/redamon, 3k stars), Nmap (BrownFineSecurity/iothackbot, 859 stars) and Systematic Attacking (mtarcure/claude-vibe-squad, 165 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Operate Network Recon?

cyberful (a GitHub organization) maintains it in cyberful/cyberful, which has 135 GitHub stars. The repository holds 85 skills in this directory. The repository was last updated on August 24, 2026.

Source: cyberful/cyberful on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.