How arafaykhalid/web-discoverability-skill works
This repository is an agent skill and command-line toolkit for auditing web discoverability, not a system that changes rankings or guarantees indexing. The principal workflow captures a site’s served output, builds a snapshot and profile, selects applicable requirements, runs deterministic checks, and reports evidence-backed findings. Separate registry-maintenance and benchmark capabilities support that audit product. The graph follows documented workflows and indexed imports; several internal check and reporting details are represented at subsystem level because their implementations were not all excerpted.
Main entry points: cli.ts CLI commands · registry.ts Registry loading · report.ts Audit and metrics reports · capture.ts Site capture
Components 19
Site audit
- CLI commands
tools/cli.ts - Site capture
tools/lib/capture.ts - Site profiling
tools/lib/profile.ts - Site snapshot
tools/lib/snapshot.ts - Requirement selection
tools/lib/select.ts
Discoverability checks
- Check registry and runner
tools/lib/checks/index.ts - Domain check modules
tools/lib/checks - Check support
tools/lib/check-support.ts - HTML inspection
tools/lib/html.ts
Requirements registry
- Requirement records
requirements - Registry vocabulary
tools/lib/model.ts - Registry loading
tools/lib/registry.ts - Registry validation
tools/lib/validate.ts
Reports and benchmarks
- Audit and metrics reports
tools/lib/report.ts - Registry documentation
tools/lib/docs.ts - Check benchmarks
tools/lib/bench.ts - Freshness check
tools/lib/version.ts
Other components
- Engineer or agent
- Target website
Connections 21
- Engineer or agent → CLI commands: runs commands
README.md - CLI commands → Site capture: captures site
tools/cli.ts - Site capture → Target website: fetches responses
README.md - CLI commands → Site snapshot: loads snapshot
tools/cli.ts - Site snapshot → Site profiling: scans project
tools/lib/snapshot.ts - CLI commands → Requirement selection: selects requirements
tools/cli.ts - CLI commands → Check registry and runner: runs audit checks
README.md - Check registry and runner → Domain check modules: loads checks
tools/lib/checks/index.ts - Domain check modules → Check support: uses shared helpers
tools/lib/checks/robots.ts - Check support → HTML inspection: parses HTML
tools/lib/check-support.ts - CLI commands → Registry loading: loads records
tools/cli.ts - Registry loading → Requirement records: reads records
tools/lib/registry.ts - Registry loading → Registry vocabulary: uses vocabulary
tools/lib/registry.ts - CLI commands → Registry validation: validates registry
tools/cli.ts - CLI commands → Audit and metrics reports: creates reports
tools/cli.ts - Audit and metrics reports → Registry validation: validates records
tools/lib/report.ts - Audit and metrics reports → Requirement selection: counts selections
tools/lib/report.ts - CLI commands → Registry documentation: generates docs
tools/cli.ts - Registry documentation → Requirement records: reads requirement corpus
tools/lib/docs.ts - CLI commands → Check benchmarks: runs benchmarks
tools/cli.ts - CLI commands → Freshness check: checks freshness
README.md