v0.6.1 — Networking Category & Geo IP Rotator, Wallet Screening v2.1 (Offline-Direct & Live Verification), Interactive Config Menu, and Skillware Find Discovery Engine

Skillware 0.6.1 introduces the networking category and its flagship networking/geo_ip_rotator (v0.1.0) skill bundle for residential/datacenter egress routing, multi-region web inspection, and strict SSRF containment; the v2.1.0 release of finance/wallet_screening featuring zero-dependency offline-direct screening and optional live verification via Chainalysis and TRM Labs; the skillware find semantic task-intent and keyword discovery engine; an interactive CLI configuration and navigation menu; complete catalog metadata standardization under Manifest v2 Universal Taxonomy; expanded empirical Skillware-Bench telemetry in COMPARISON.md; and strict static typing for the skill loader.

Install: pip install skillware==0.6.1 or pip install -U skillware or pip install skillware

Update from 0.6.0: pip install -U skillware

---

Added

Category: networking & Flagship Egress Gateway (#437, #464)

• Networking Category Launch: Established the dedicated networking category (skills/networking/), category documentation hub (docs/skills/networking/README.md), cat: networking issue/PR label, and skill proposal template integration.
• networking/geo_ip_rotator (v0.1.0): Enterprise-grade geographic egress proxy routing and anti-blocking gateway for autonomous agents:
  • fetch_via_geo: Targeted single-region HTTP/HTTPS requests routed through residential, datacenter, or mobile egress nodes across 16 global jurisdictions.
  • compare_regions: Concurrent multi-country web inspection computing side-by-side variance in status codes, localized prices, detected currencies, regional redirects, and cookie consent banners across 2 to 5 jurisdictions simultaneously.
  • resolve_egress: Pre-flight exit node probing verifying confirmed IP, ASN, ISP, country, and regulatory jurisdiction without contacting external targets.
  • get_proxy_context: Downstream proxy configuration generator emitting structured dictionaries formatted for requests, httpx, aiohttp, playwright, curl, and urllib.
  • list_supported_regions: Searchable catalog of supported regional countries and network pool tiers.
  • Strict SSRF Guardrails: Pre-flight DNS resolution validating every returned IP against loopback (127.0.0.1, ::1), cloud metadata (169.254.169.254, 100.100.100.200, fd00:ec2::254), private RFC 1918 subnets (10/8, 172.16/12, 192.168/16), Carrier-Grade NAT (100.64.0.0/10), numeric IP bypass representations, and re-validating every redirect hop.
  • Pluggable Commercial Adapters: Format profiles for BrightData, Oxylabs, Smartproxy, IPRoyal, and generic HTTP/SOCKS5 proxies.
  • Data Sovereignty Compliance: Verifiable SHA-256 cryptographic audit receipts and configurable jurisdictional fencing (allow_eea_only, sanctions blocklists).
  • Deterministic Offline Simulation: 800+ lines of curated regional profiles covering 16 countries with verified public ASNs, ISPs, and city nodes for 100% hermetic offline testing and CI execution.
• Runnable Demo & Simulations: Added standalone demonstration script examples/geo_ip_rotator_demo.py with CI smoke test registration, and 6-scenario enterprise simulation suite tests/skills/networking/test_geo_ip_rotator_simulations.py.

Semantic Discovery Engine: skillware find (#456)

• SkillMatcher Core Engine (skillware.core.matcher): Multi-field weighted scoring algorithm evaluating natural language intent against skill names, categories, taxonomy tags, action names, and short descriptions with token overlap and intent normalization.
• CLI Discovery Command: skillware find <query> supporting Manifest v2 taxonomy filtering (--shape, --tier, --target, --tag, --category, --ready-only, --top, --min-confidence, --json, --inspect).
• Programmatic APIs: Exposed find_skills() and inspect_skill() public APIs for dynamic agent discovery loops.

Interactive Configuration Menu (#455, #458)

• Consolidated 7-Item Main Menu: Prioritizes find at option 1 and organizes setup actions under option 4 (config), including submenus for search paths, UI themes, EVM chains/tokens, dedicated agent mail, address book management, config inspection, and file opening.

---

Changed

finance/wallet_screening v2.1.0 (#439, #461)

• Offline-Direct Screening Mode: When ETHERSCAN_API_KEY is omitted, the skill falls back cleanly to metadata.mode: offline_direct_only, performing instant, zero-latency direct screening against bundled OFAC SDN, TRM, and malicious contract databases without raising errors.
• Optional Live Verification: Configurable via CHAINALYSIS_API_KEY and TRM_SANCTIONS_API_KEY. Live provider findings populate risk_details.live_verification[]. Sanctions matches elevate risk level to critical / DENY with LIVE_SANCTIONS_MATCH evidence, while provider timeouts or rate limits record non-fatal warnings in metadata.warnings.

Documentation, Telemetry, and Repository Sweeps (#448, #462, #463)

• Manifest v2 Metadata Standard: Standardized Manifest v2 taxonomy headers as clean, scannable bulleted lists across all skill catalog pages in docs/skills/.
• Skillware-Bench Telemetry: Overhauled COMPARISON.md and README.md comparison sections with 9 empirical Skillware-Bench figures and telemetry tables, illustrating JIT context excision (85% token reduction), 55.6% lower median execution latency, and 5.1x tighter run-to-run variance against unassisted script generation.
• Glossary & Sitemap Synchronization: Modernized docs/glossary.md with Universal Taxonomy primitives, disambiguated provenance root tiers from deployment tiers, synchronized docs/sitemap.md with all guides, and updated docs/security/skill-trust-model.md with physical/bioware safety gate specifications.
• Maintainer Runbook: Added line-by-line manual verification and doc sweep guidelines to CONTRIBUTING.md and docs/contributing/ai_native_workflow.md.

Core Typing (#415, #460)

• Strict Type Checking (Phase 3): Fully typed skillware/core/loader.py, removing it from the mypy override ignore list and enforcing strict type validation in CI.

---

Highlights & Code Examples

1. Targeted Geo IP Routing & Multi-Region Inspection (networking/geo_ip_rotator)

from skillware.core.loader import SkillLoader

bundle = SkillLoader.load_skill("networking/geo_ip_rotator")
skill = bundle["class"]()

# Fetch UK notice through London residential egress
result = skill.execute({
    "action": "fetch_via_geo",
    "url": "https://service.gov.uk/regional-notice",
    "country": "GB",
    "city": "London",
    "network_type": "residential",
})
print("Confirmed Egress IP:", result["egress"]["ip"])
print("Jurisdiction:", result["sovereignty"]["jurisdiction_code"])

# Concurrently compare pricing across 4 jurisdictions
comparison = skill.execute({
    "action": "compare_regions",
    "url": "https://example-saas.com/pricing",
    "regions": ["US", "GB", "DE", "JP"],
})
print("Detected Currencies:", comparison["variance_detected"]["currency_variance"])

2. Zero-Dependency Offline-Direct Sanctions Screening (finance/wallet_screening v2.1)

from skillware.core.loader import SkillLoader

bundle = SkillLoader.load_skill("finance/wallet_screening")
skill = bundle["class"]()

# Screen address without an Etherscan API key
result = skill.execute({
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
})

print("Mode:", result["metadata"]["mode"])  # "offline_direct_only"
print("Decision:", result["verdict"]["decision"])  # "ALLOW" or "DENY"
print("Risk Level:", result["verdict"]["risk_level"])

3. Natural Language Intent Discovery (skillware find)

# Discover skills by plain-English user intent
skillware find "fill out a government tax form from pdf"

# Filter discovery by execution geometry and domain tags
skillware find "rotate egress ip address" --shape middleware --tag networking

---

Upgrade notes

• Version Bump: Run pip install -U skillware to upgrade to 0.6.1.
• Optional Extras: Install networking dependencies with pip install "skillware[networking_geo_ip_rotator]" or pip install "skillware[networking]".
• Etherscan Key Optional: finance/wallet_screening no longer fails when ETHERSCAN_API_KEY is unset; it executes in offline_direct_only mode against bundled sanctions lists.
• Supported-version policy: >= 0.6.0 supported and patched; 0.4.6 – 0.5.9 silent; < 0.4.6 unsupported advisory emitted.

---

Full changelog

CHANGELOG.md — 0.6.1

---

Contributors

Thanks to everyone who contributed to this release:

• @rosspeili — skillware find semantic intent discovery engine and SkillMatcher (#456); comparison overhaul with Skillware-Bench empirical exhibits and telemetry in COMPARISON.md and README.md (#463); sitemap, glossary, and trust model modernization (#463); maintainer doc sweep guidance (#463); skill history reconciliation and 0.6.1 release bump
• @bd-c3 — networking category establishment and networking/geo_ip_rotator v0.1.0 egress routing gateway with SSRF guardrails, commercial provider adapters, and deterministic offline simulation suite (#437, #464)
• @Hendobox — finance/wallet_screening v2.1.0 offline-direct screening mode, optional live Chainalysis and TRM Labs verification, and live risk factor retention (#439, #461)
• @ect2000 — Interactive CLI configuration menu reorganization, consolidating config actions and prioritizing discovery (#455, #458)
• @rin-katsuragi — Manifest v2 taxonomy metadata standardization as scannable bulleted lists across all skill catalog pages (#448, #462)
• @uroojfatima-6789 — Core typing Phase 3: static type annotations for skillware/core/loader.py under mypy (#415, #460)

---

Citation

Zenodo concept DOI: 10.5281/zenodo.21552745 — record Skillware v0.6.1 for reproducibility (CITATION.cff updated).