Add RFSAM Skill: AI agent methodology for RF security audits (7-layer descent over 15 RF protocols) - #2
Open
DragonJAR wants to merge 6 commits into
Open
Add RFSAM Skill: AI agent methodology for RF security audits (7-layer descent over 15 RF protocols)#2DragonJAR wants to merge 6 commits into
DragonJAR wants to merge 6 commits into
Conversation
Primera version de SKILL.md para que un agente entienda y aplique RFSAM
…urales y de cobertura
Typos/redacción:
- SKILL.md: `.loop*` -> `loot/` (gitignore instruía mal, exponía a commitear capturas)
- 01-autorizacion.md: equipment ownerr -> owner, bosechada -> estructura,
rteléfono -> teléfono
- 10-ble.md: correlar -> correlacionar; título control CR alineado con coverage-map
("Pairing and encryption assessment")
- 14-lte.md: caracter chino espurio 下行 -> "DL)"
- 15-rfid.md: "relayed credenciales" -> "relay credenciales"
- 18-zwave.md: Triggrear -> Disparar; espanglish "adds potencia y star topology"
-> "añade potencia y topología estrella"
- 24-uwb.md: intentp -> intento
Referencias rotas (13 lugares): reescritas a archivos que existen en references/
- docs/phase4-mitigations.md -> references/03-registro-hallazgos.md §7
- docs/phase4-*-*.md -> references/25-troubleshooting.md (§1/§2/§4)
- docs/rfsam-tools-registry.md -> references/02-kit-sdr.md
- docs/rfsam-quality-rules.md -> references/26-calidad.md (secciones internas)
- RFSAM-git/scripts/validate.mjs -> scripts/register_finding.py
Estructura ADS-B:
- 21-adsb.md: headers separados (### PHY / ### LL / ### AT, un control por header)
- RFSAM-ADSB-AT-01 añadido a los 3 sitios canónicos:
src/data/coverage-map.js, scripts/coverage_check.py, references/00-taxonomia.md §6
Sección ## Subflujo añadida a 8 wayfinders (LTE, ZWave, Thread, GNSS, ADS-B,
NR5G, GSM, UWB) para cumplir lo que SKILL.md §Fase 0 promete. Ahora los 15
wayfinders tienen la tabla de transiciones + bloque "Anomalía defensiva".
DRY:
- register_finding.py: regex de control derivada de los sets PROTOCOLS/LAYERS
(estricta), rechaza IDs con proto/layer no canónicos.
- coverage_check.py: comentario que marca src/data/coverage-map.js como fuente
única de los 3 sitios (JS/Python/MD).
Menores:
- SKILL.md: placeholders del snippet de checkpoint marcados como {{...}}
- scaffold_report.py: f-string críptico de la fila de remediación refactorizado
Verificación:
- python3 scripts/register_finding.py --self-test OK
- coverage-map.js: 50 controles, todos canónicos, únicos, 15 protocolos
(PY/JS/MD sincronizados)
- tests integrales: RFSAM-ADSB-AT-01 válido; proto/layer inválidos rechazados
…al (#1) Corrige typos, 13 referencias rotas a docs/*.md inexistentes, inconsistencias estructurales (wayfinders sin ## Subflujo, ADS-B sin control AT) y divergencia regex↔taxonomía. DRY: coverage-map sincronizado en JS/Python/MD. Verificación: register_finding --self-test OK, 50 controles canónicos, tests integrales pasan.
- LTE (14-lte.md): PBH → PBCH (Physical Broadcast Channel) - 5G NR (22-nr5g.md): PBH → PBCH (2 occurrences) + Wireshar → Wireshark - Zigbee (17-zigbee.md): S2-style ECDH → install-code AES-MMO (Zigbee 3.0 uses symmetric install codes, not Z-Wave S2 ECDH) - Zigbee + Thread (17-zigbee.md, 19-thread.md): cativity → activity - .gitignore: add __pycache__/ and Skill/loot/ to prevent accidental commits of Python cache files and audit secrets
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a complete, self-contained
Skill/folder that turns any AI agent (Claude, ChatGPT, etc.) into a senior RF security auditor following the RFSAM methodology — a structured 7-layer descent (IG→SP→PHY→LL→CR→AT→AP) across 15 RF protocols, with an authorization gate, reproducible evidence workflow, and quality rubric.Cross-fork PR from DragonJAR/RFSAM. The skill was developed and validated in the fork before opening this PR.
What
Skill/addsWhy
RFSAM (Electronic Cats) is a web tool for RF security assessment methodology. This skill package makes the methodology portable to any AI assistant, so an auditor can load it and get structured guidance through the full 7-layer descent with protocol-specific commands, authorization gates, and reproducible evidence requirements — without needing the web app.
Authorization-first design
The skill enforces a hard authorization gate before any active step:
Not included
Skill/folder +.gitignore)loot/directory (captures, keys, findings) is gitignored and never committedValidation
coverage_check.py,register_finding.py --self-test)§Norreferences/XX-name.mdlinks)