codebase-map
Where things live in the portal-tunnel repo (sdk/portal/types/utils/cmd/discovery/x402/frontend/extensions) and where new code belongs. Use when locating functionality or deciding where to add code.
Perfil del activo
Agents de programación y desarrollo
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Escenario
Testing and QA
I need my agent to test a web app, reproduce bugs, and verify fixes.
Afinidad con Agent
Claude Code + Browser agents + CLI
Funciona con Codex, Claude Code, Cursor, CLI o Agents personalizados.
Instalar
Listo
npx skills add gosuda/portal-tunnel --skill codebase-map
Mantenimiento
Actual
Actualizado hoy
Riesgo
Requiere revisión
Dependency or permission surface needs review
Calidad de GitHub
263
71/100 Calidad · 74/100 Confianza
Etiquetas de cobertura
Notas de revisión
Dependency or permission surface needs review · Permission surface may require sandboxing
Tarjeta de adopción del Agent
Confianza, auditoría y preparación de instalación de un vistazo
Estas puntuaciones combinan metadatos públicos del repositorio, señales de revisión de OpenAgentSkill, actualidad de mantenimiento y preparación de instalación. Sirven para preseleccionar; no sustituyen la revisión humana.
Calidad
SólidoSolid option that is likely worth shortlisting for production workflows.
Confianza
Solo sandboxCandidata útil con señales de confianza incompletas o mixtas. Manténgala en un espacio aislado hasta que el ciclo de resultados demuestre el ajuste.
Auditoría
Requiere revisiónRevisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.
Trust Score de OpenAgentSkill v5
Revisión humana antes de instalar
Ejecute solo en un sandbox y compare alternativas cercanas antes de usarla en trabajo real.
Estrellas
263 estrellas de GitHub
Actividad del repositorio
263 estrellas y 29 forks
Mantenimiento
Actualizado hoy
Licencia
MIT
Instalar
npx skills add gosuda/portal-tunnel --skill codebase-map
Seguridad de instalación
Ruta estándar de paquete o instalación en tiempo de ejecución
Superficie de permisos
shell or command execution, filesystem or document access
Resultados del Agent
Aún no hay datos de resultados del Agent
Documentación
Usable metadata, review docs
Resumen de riesgo
Revisar antes de producción
- Quality score needs review
- Permission surface needs review: shell or command execution, filesystem or document access
- Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata
- Dependency/runtime risk: command execution surface, external package install surface
Preparación de instalación
Ruta de instalación disponible
- La ruta de instalación está disponible
- La evidencia del repositorio está disponible
- La licencia está declarada
- Aún no hay evidencia de resultados Agent-Proven
Metadatos legibles por Agent
Datos de decisión legibles por máquina para este skill.
Usa este bloque o el JSON integrado para decidir si un Agent debe instalar este skill, elegir una alternativa o pedir revisión humana primero.
Tareas adecuadas
- flujos de Browser automation
- Equipos de Claude Code
- builders willing to evaluate younger projects
- Navigate pages
Agents adecuados
Decisión de instalación
- Comando
- npx skills add gosuda/portal-tunnel --skill codebase-map
- Política
- Revisar
- Revisión humana
- Sí
Confianza y riesgo
- Confianza
- 66/100
- Auditoría
- 80/100
- Nivel de riesgo
- Requiere revisión
Ciclo de resultados
- Endpoint
- /api/agent/outcome
- ID del evento
- resolve
- Resultados
- 5
Comando de instalación
npx skills add gosuda/portal-tunnel --skill codebase-mapNo usar cuando
- Equipos que necesitan un SLA con soporte del proveedor
- Entornos de alta conformidad sin revisión interna de seguridad
- No OpenAgentSkill engagement data yet
- Indicios de permisos de alto riesgo: ejecución de shell o comandos
- Dependency or permission surface needs review
Skill alternativo
Code Review
168.6K Estrellas
npx skills add mattpocock/skills --skill code-review
Skill alternativo
Grill With Docs
164.7K Estrellas
npx skills add mattpocock/skills --skill grill-with-docs
Skill alternativo
To Spec
164.7K Estrellas
npx skills add mattpocock/skills --skill to-spec
Skill alternativo
To Tickets
176.7K Estrellas
npx skills add mattpocock/skills --skill to-tickets
Seguridad de Agent v2
48/100 · Evitar instalación automática
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
Alto
Ejecución de shell o comandos
Los metadatos del skill hacen referencia a terminal, CLI, shell, subprocesos o flujos de ejecución de comandos.
Medio
Browser automation
Skill may drive a browser or interact with web pages.
Medio
Acceso a red
El skill probablemente consulta páginas remotas, API, repositorios o servicios externos.
Medio
Acceso al sistema de archivos
El skill puede leer o escribir archivos de proyecto, documentos, artefactos generados o estado local.
- Indicios de permisos de alto riesgo: ejecución de shell o comandos
- Dependency or permission surface needs review
Destinos de instalación
Instala este skill en tu flujo de Agent
Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.
OpenAgentSkill CLI
Resolve policy, run the source installer safely, and report a verified install receipt.
$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install gosuda-codebase-mapPlan de resolución de Agent
Deja que un Agent valide el ajuste antes de instalar.
La API Resolve devuelve la skill elegida, alternativas, política de seguridad, notas de auditoría, destino de instalación y un prompt listo para usar.
Abrir JSON
/api/agent/resolve?task=Use%20codebase-map%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Texto de Resolve
/api/agent/resolve?task=Use%20codebase-map%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Traspaso de instalación
/api/skills/gosuda-codebase-map/install
Agent debe revisar
- Task fit and alternatives from Resolve API.
- Audit score, trust score, and safety policy warnings.
- Install target compatibility for Codex, Claude Code, Cursor, or CLI.
Copiar prompt
Task: Use codebase-map in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20codebase-map%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/gosuda-codebase-map/install
Install command: npx skills add gosuda/portal-tunnel --skill codebase-map
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Traspaso de Agent
Da al Agent la ruta de instalación, no otro directorio.
Usa el endpoint público para obtener el comando, la lista de seguridad, prompts y enlaces canónicos.
Traspaso de instalación
/api/skills/gosuda-codebase-map/install
Formato de texto LLM
/api/skills/gosuda-codebase-map/install?format=text
Buscar alternativas
/api/skills/search?q=codebase-map&limit=3
Prompt de Agent
Use codebase-map for this task. Review https://www.openagentskill.com/api/skills/gosuda-codebase-map/install, then install with: npx skills add gosuda/portal-tunnel --skill codebase-mapMetadatos del Registry
Perfil legible por Agent para seleccionar skills automáticamente.
La API Registry expone señales de decisión, confianza, auditoría, casos de uso e instalación sin raspar la interfaz.
Manifest
/api/registry/manifest/gosuda-codebase-map
Texto LLM
/api/registry/manifest/gosuda-codebase-map?format=text
Alias de instalación
/api/registry/install/gosuda-codebase-map
Recomendar
/api/registry/recommend?task=Use%20codebase-map%20in%20an%20agent%20workflow&limit=3
Afinidad con Agent
Browser automation
Etiquetas de uso
Plataformas
Claude Code, Browser agents
Informe de auditoría
Requiere revisión · 80/100
Revisión legible por máquina de la preparación de instalación, los metadatos de seguridad, el mantenimiento y el riesgo de adopción.
Panel de decisión de Agent
Fallback candidate for Browser automation
Prototype with this skill first; keep a fallback candidate ready.
Rol en la pila
Candidata de respaldo
Ajuste principal
Browser automation
Etiqueta de confianza
Prototipar primero
Ruta de instalación
Comando listo
Úsalo cuando
- flujos de Browser automation
- Equipos de Claude Code
- builders willing to evaluate younger projects
Evidencia
- recent repository activity
- install command or GitHub repo available
- perfil de calidad 71/100
revisar primero
- No OpenAgentSkill engagement data yet
Ruta de implementación
- 1Instálalo en un Agent de sandbox y ejecuta una tarea de Browser automation de principio a fin.
- 2Compare output quality, latency, and failure behavior against at least one alternative.
- 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.
Perfil de confianza
Solo sandbox
Candidata útil con señales de confianza incompletas o mixtas. Manténgala en un espacio aislado hasta que el ciclo de resultados demuestre el ajuste.
Adopción en GitHub
Info263 estrellas de GitHub
Actividad de stars/forks
Revisar263 estrellas y 29 forks; la actividad de issues no está disponible en los metadatos actuales
Mantenimiento reciente
AprobadoActualizado hoy
Claridad de licencia
AprobadoMIT
Señales positivas
- Revisión de IA aprobada
- La ruta de instalación está disponible
- La evidencia del repositorio está disponible
- Repositorio mantenido recientemente
- El comando de instalación no muestra un patrón de alto riesgo evidente
- El ciclo de resultados está listo, pero necesita la primera ejecución real de Agent
Revisar antes de instalar
- Quality score needs review
- Permission surface needs review: shell or command execution, filesystem or document access
- Stars/forks activity: 263 stars, 29 forks; issue activity unavailable in current metadata
- Dependency/runtime risk: command execution surface, external package install surface
- Permission surface: shell or command execution, filesystem or document access
- Aún no hay informes reales de resultados del Agent
- Se requiere revisión humana antes de una instalación desatendida
Acción recomendada
Ejecute solo en un sandbox y compare alternativas cercanas antes de usarla en trabajo real.
Perfil de calidad
Sólido candidato para flujos de Agent
Solid option that is likely worth shortlisting for production workflows.
Ajuste de flujo
Usa esta skill en estos escenarios
Operate web apps
Browser automation
I need my agent to control a browser, fill forms, and verify web app workflows.
Verify behavior
Testing and QA
I need my agent to test a web app, reproduce bugs, and verify fixes.
Operate local tools
Local desktop
I need my agent to operate local files and desktop apps in a repeatable workflow.
Ajuste de flujo
Añadir a un flujo completo
Operate and verify web apps
Browser QA agent
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Design, build, test, and ship interfaces
Frontend and UI
A practical workflow for agents that turn product briefs or Figma designs into polished frontend code, review the result, test it in a browser, and prepare a safe deployment.
Scrape, clean, and reuse web data
Web data pipeline
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Lista de alternativas
Compara antes de instalar
Similar skills that may fit this task.
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
Grill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
To Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
To Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
Resumen
--- name: codebase-map description: Where things live in the portal-tunnel repo (sdk/portal/types/utils/cmd/discovery/x402/frontend/extensions) and where new code belongs. Use when locating functionality or deciding where to add code. ---
# portal-tunnel codebase map
Portal is a zero-knowledge tunneling relay + local runtime: exposes local HTTP/TCP/UDP services through self-hosted or public relays with end-to-end tenant TLS, ECH SNI hiding, MITM self-probe, multi-hop routing, and x402 payments.
## Top-level packages - `sdk/` — **client side**. Tunnel exposure and relay API client, listener/session management, HTTP routing + proxying, MITM detection. Entry points: `sdk/expose.go`, `sdk/listener.go`, `sdk/http.go`, `sdk/proxy.go`, `sdk/mitm.go`. x402 route protection is applied here (`sdk/http.go`). - `portal/` — **relay side**. API/server lifecycle (`portal/api_server.go`, `portal/server.go`), leases, proxying, identity, keyless TLS/ECH, overlay transports, policy, telemetry, ACME. - `portal/discovery/` — relay gossip: `announce.go` (rate limiting), `refresher.go` (poll descriptors + `POST /discovery/announce` self-announce + peer refresh), `relayset.go` (validated pool, bans, route-planning state), `relaystate.go`, `mols.go` (route scoring). - `portal/x402/` — payment gating: `handler.go`, `payment.go`, `casper.go`, `x402.go`, embedded browser `client.js`. Facilitator mounts at `/api/x402` only when `X402_ENABLED`. - `types/` — **shared contracts**: protocol/API/data models, identity & transport types, x402 types, and public path constants (`types/paths.go`). `types/types.go` unmarshals the embedded `config.toml`/`registry.json`. Put shared constants and public path strings HERE. - `utils/` — shared **stateless** helpers: API encoding, command dispatch (`utils/cmd.go`), files, paths, HTTP, name/network/TLS normalization, snapshots. - `cmd/` — executables: `cmd/portal-tunnel` (client CLI), `cmd/relay-server` (relay + embedded SPA), `cmd/portal-loadtest` (`make load-test`), plus demo/payment apps. - `frontend/` — React + Tailwind SPA (Vite). Built and embedded into the relay binary at `cmd/relay-server/dist/app` (`//go:embed dist/*`). Dev server at `http://localhost:5173`; point at a live relay with `VITE_PORTAL_API_BASE_URL`. - `docs/` — SvelteKit docs site (`make build-docs`, uses bun). - `extensions/vscode/` — VS Code extension (start/stop tunnel commands, relay/host/name settings).
## Root files - `config.toml` — embedded release version + protocol versions (via `manifest.go`). - `registry.json` — embedded default public relay list → `types.BootstrapRelays`. - `manifest.go` — `//go:embed` of the two files above. - `docker-compose.yml` / `Dockerfile` — relay container build/deploy.
## Where new code belongs (AGENTS.md) - Shared contract / constant / public path → `types/` (one owner, no duplication). - Stateless transform reused across packages → `utils/`. - Stateful/domain logic → its real owner in `sdk/` or `portal/` (resolve complexity in the lowest coherent owner, expose minimum surface). - Avoid speculative abstraction, wrappers with no boundary, and dead fields; remove stale code while nearby.
Detalles técnicos
- Versión
- 1.0.0
- Licencia
- MIT
- Última actualización
- 22 ago 2026
- Publicado
- 22 ago 2026
Resumen de decisión
Candidata de respaldo
recent repository activity
Auditoría
Revisión de instalación
Revisión de instalación y adopción
- Seguridad
- 79/100
- Mantenimiento
- 100/100
- Instalar
- 92/100
Evidencia probada por Agent
Evidencia probada por Agent
Informes de resultados tras resolver, revisar, instalar y una ejecución limitada.
- Tasa de éxito
- —
- Fallo reciente
- —
- Resultados
- 0
- Calidad de salida
- —
- Fallidos
- 0
- No relevante
- 0
- Instalaciones
- 0
- Bloqueado por riesgo
- 0
- Configuración necesaria
- 0
- Producción
- 0
Aún no hay datos de resultados de Agent. La primera ejecución puede informar éxito, configuración necesaria, bloqueos de riesgo, fallo o irrelevancia mediante /api/agent/outcome.
Instalar
Añadir al flujo de Agent
Gratis y de código abierto. Revisa el informe antes de instalar en Agents de producción.
Bucle de crecimiento
Kit para compartir
Borrador basado en un caso para codebase-map, listo para publicar manualmente en X.
codebase-map: Where things live in the portal-tunnel repo (sdk/portal/types/utils/cmd/discovery/x402/fronte... 263 stars https://www.openagentskill.com/skills/gosuda-codebase-map?ref=x
Respuesta opcional con comando de instalación
Listing + install path for codebase-map: https://www.openagentskill.com/skills/gosuda-codebase-map?ref=x Install: npx skills add gosuda/portal-tunnel --skill codebase-map
Fuente de la ficha
Indexado por Registry
Esta ficha se indexó desde fuentes públicas y no está marcada como oficial hasta que se apruebe una reclamación de mantenedor.
- Creador
- gosuda
- Fuente
- gosuda/portal-tunnel
- Indexado por
- Índice comunitario de OpenAgentSkill
La atribución enlaza al repositorio público o al perfil del creador. Los creadores pueden reclamar la ficha para actualizar las señales de propiedad.
Reclamar este skillReclamación del propietario
Reclamar esta ficha de skill
Esta ficha Indexado por Registry se atribuye a gosuda, pero aún no está marcada como oficial. Reclámala para añadir una señal de propietario verificado y hacer más fiables futuras actualizaciones de lanzamiento, instalación y auditoría.
Kit de enlaces para creadores
Añade las insignias de evidencia a tu README
Muestra la ficha canónica, las señales actuales de confianza y auditoría, y evidencia real de Agent-Proven donde los desarrolladores evalúan el repositorio.
[](https://www.openagentskill.com/skills/gosuda-codebase-map)
[](https://www.openagentskill.com/skills/gosuda-codebase-map)
[](https://www.openagentskill.com/skills/gosuda-codebase-map/audit)
[](https://www.openagentskill.com/skills/gosuda-codebase-map)Autor
gosuda
@gosuda
Etiquetas
Afinidad con plataforma
Señales de salud
- Estrellas de GitHub
- 263
- Puntuación de calidad
- 41/100
- Último push de GitHub
- 22 ago 2026
- Pistas del framework
- Desconocido
- Vistas de OpenAgentSkill
- 0
- Copias de instalación
- 0
- Clics externos
- 0
Señal de comunidad
Comparte si este skill resulta útil para tu flujo de Agent. Los comentarios agregados mejoran la clasificación con el tiempo.
Confianza y seguridad
Solo sandbox
- Adopción en GitHub263 estrellas de GitHubInfo
- Actividad de stars/forks263 estrellas y 29 forks; la actividad de issues no está disponible en los metadatos actualesRevisar
- Mantenimiento recienteActualizado hoyAprobado
- Claridad de licenciaMITAprobado
- Completitud de README/SKILL.mdLos metadatos públicos necesitan más contexto de README/SKILL.mdInfo
- Riesgo de dependencias/runtimecommand execution surface, external package install surfaceRevisar
Skills relacionados
Code Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K EstrellasGrill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
164.7K EstrellasTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K EstrellasTo Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
176.7K Estrellas