$ show hahwul/WebHackersWeapons
WebHackersWeapons is a curated, YAML-driven knowledge base and static documentation generator for web hacking and bug bounty tools, rather than a runnable application. Its core truth layer is 530+ weapons/*.yaml files, each defining a tool's name, URL, description, category, type, platform, language, and tags. These files are transformed by Ruby ERB scripts into a generated README and categorized pages by language and vulnerability tag, with schema validation enforced by scripts/validate_weapons.rb and CI via GitHub Actions. The repository behaves as a structured dataset with a small ETL pipeline: YAML metadata -> validated catalog -> Markdown cross-reference pages.
The LLM identified 3 files worth highlighting for reuse:
Standalone Ruby script that loads every weapons/*.yaml entry and enforces required fields and allowed values for type, language, and tags. It demonstrates a lightweight, dependency-free data-governance pattern that can be adapted to validate any YAML-based catalog or metadata corpus.
ERB template generator that reads all YAML tool definitions and emits README.md plus categorize/tag and categorize/language pages. It cleanly decouples content from presentation and is reusable for any curated metadata catalog that needs automatic cross-referenced documentation.
Bulk migration script that converts legacy JSON tool metadata into the current YAML schema and fetches language information from the GitHub API. It provides a reusable pattern for migrating between metadata schemas and enriching records from external APIs, though rate-limit handling makes it slower in practice.