CommunityRedacción y edicióngithub.com

swiftpostlabs/agentic-tools

Habilidades y herramientas compartibles para agentes de IA

¿Qué es agentic-tools?

Este skill proporciona configuraciones predeterminadas portables para proyectos Deno modernos, especialmente cuando el código base combina Deno con herramientas orientadas a Node, necesita una migración limpia desde patrones antiguos de Deno, o está adoptando Deno en un repositorio TypeScript o Node existente. Es útil para escribir scripts, servidores o código de borde con Deno, configurar `deno.json`, tareas y fuentes de dependencia, y adaptar `tsconfig.json` o `eslint.config.*` existentes para coexistir con Deno. El skill cubre reglas esenciales para TypeScript y `tsconfig.json`, linting y formateo con `deno lint` y `deno fmt`, compatibilidad con Node y repositorios híbridos, permisos y seguridad, y resolución de problemas y migración. Se recomienda para entornos híbridos donde Deno y Node comparten el mismo repositorio, ofreciendo pautas claras para evitar conflictos entre herramientas y mantener una configuración explícita y moderna. Plataformas compatibles: Claude Code, Cursor, Codex y otras herramientas que admitan skills de agente.

Compatible con~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add swiftpostlabs/agentic-tools

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Deno

Propósito

Proporcionar configuraciones predeterminadas portables para proyectos modernos de Deno, especialmente cuando el código base combina Deno con herramientas orientadas a Node, necesita una ruta de migración limpia desde patrones antiguos de Deno, o está adoptando Deno en un repositorio TypeScript o Node existente.

Cuándo usar esta habilidad

  • Escribir scripts, servidores o código de borde con Deno.
  • Configurar deno.json, tareas y fuentes de dependencia.
  • Adaptar tsconfig.json o eslint.config.* existentes para coexistir con Deno.
  • Mezclar código Deno con código Node o TypeScript en un solo repositorio.
  • Revisar permisos, pruebas o patrones de tiempo de ejecución de Deno.

Valores predeterminados

  • Usar deno.json como la fuente de verdad de Deno.
  • Preferir deno check, deno task, deno fmt, deno lint y deno test sobre envoltorios ad hoc cuando Deno es el propietario del flujo de trabajo.
  • Las herramientas nativas de Deno son suficientes para el código propiedad de Deno; usar Yarn solo cuando el repositorio también tenga paquetes o scripts gestionados por Node fuera del límite de Deno.
  • Mantener tsconfig.json solo para rutas propiedad de Node o para casos de gráfico de proyecto TypeScript que los espacios de trabajo y ámbitos de directorio de Deno no puedan expresar limpiamente.
  • Recordar que el Node moderno también ejecuta TypeScript directamente a través de la eliminación de tipos incorporada; elegir Deno por su modelo de tiempo de ejecución, permisos, dependencias y herramientas, no solo para evitar tsc o ts-node.
  • Preferir deno lint y deno fmt para archivos propiedad de Deno; agregar ESLint solo cuando el repositorio o el editor realmente necesiten el ecosistema de ESLint.
  • Al reemplazar ESLint con deno lint, inspeccionar y trasladar la intención existente de ESLint a las inclusiones, exclusiones, reglas de lint o excepciones documentadas de deno.json en lugar de descartar la configuración por completo.
  • Al reemplazar tsc con deno check, inspeccionar el tsconfig.json existente y traducir las opciones del compilador, inclusiones, exclusiones, bibliotecas y expectativas de rigor relevantes a deno.json o un tsconfig.json retenido con ámbito claro.
  • Cuando herramientas de editor respaldadas por npm, como ESLint, deban ejecutarse dentro de un repositorio Deno, configurar nodeModulesDir: "auto" y envolver el comando en deno task.
  • Cuando Deno sea el propietario de la gestión de dependencias, instalar dependencias con deno add, no tratar deno run npm:<paquete> como un sustituto de la instalación. Usar deno add --dev npm:<paquete> para CLI y herramientas de solo desarrollo.
  • Para herramientas CLI instaladas, nombrar la deno task según la herramienta e invocar el binario instalado por nombre; por ejemplo, después de deno add --dev npm:herramienta-ejemplo, agregar "herramienta-ejemplo": "herramienta-ejemplo".
  • Preferir módulos .ts por defecto en el código propiedad de Deno; no recurrir a JavaScript solo para evitar un paso de compilación que Deno no requiere.
  • Preferir paquetes JSR, especificadores npm: o entradas de mapa de importación explícitas sobre importaciones de URL heredadas dispersas.
  • Cuando una CLI respaldada por npm tenga un comportamiento de instalación o postinstalación que no coopere limpiamente con la ejecución única, preferir nodeModulesDir: "auto", permitir el paquete en allowScripts, agregar la dependencia con deno add o deno add --dev, e invocar el binario instalado desde una deno task.
  • Deno 2 es intencionalmente compatible con package.json, paquetes npm y módulos integrados de Node; mantener la configuración específica de Deno en deno.json en lugar de intentar que tsconfig.json maneje ambos mundos.
  • Preferir APIs estándar web y Deno.serve para servidores.
  • Tratar los permisos como una decisión de diseño, no como una ocurrencia tardía.

Encuadre de tareas

Comando o acciónQuéPor quéCuándoResultado esperado
Adoptar tsconfig.json y ESLint cuidadosamenteDecidir qué permanece en la configuración propiedad de Node y qué se mueve a deno.json.Los repositorios híbridos se vuelven ruidosos rápidamente cuando ambos conjuntos de herramientas intentan ser propietarios de los mismos archivos.Al introducir Deno en un código base TypeScript o Node existente.Las herramientas de Deno y Node tienen límites de propiedad explícitos.
Configurar deno.jsonDefinir tareas, opciones del compilador y convenciones de dependencia en el archivo de configuración de Deno.Deno debe ser propietario de su propio flujo de trabajo en lugar de tomar prestada la configuración céntrica en Node por accidente.Al iniciar o reestructurar un proyecto Deno.Los comandos de Deno y el comportamiento del editor son consistentes.
Instalar una CLI npm propiedad de DenoEjecutar deno add --dev npm:<paquete> para herramientas de desarrollo, luego agregar una tarea con el mismo nombre que invoque el binario instalado.La dependencia, el archivo de bloqueo, el binario local y el punto de entrada de la tarea se mantienen alineados bajo el administrador de paquetes de Deno.Al agregar herramientas como generadores de código, CLI de automatización de navegadores, linters o formateadores a un flujo de trabajo propiedad de Deno.deno.json y el archivo de bloqueo registran la dependencia, y deno task <herramienta> ejecuta la CLI instalada.
Establecer límites híbridosSeparar las rutas propiedad de Deno de las rutas propiedad de Node en repositorios mixtos.Los conflictos de herramientas son una de las fallas más comunes en repositorios híbridos.Cuando el código Deno coexiste con herramientas Node o TS.Los editores y comandos no compiten por los mismos archivos.
Revisar permisosElegir banderas --allow-* explícitas o conjuntos de permisos nombrados para el acceso en tiempo de ejecución.El modelo de seguridad de Deno solo ayuda cuando los permisos son deliberados.Antes de ejecutar nuevos scripts o exponer un flujo de trabajo CLI de Deno.El acceso al sistema de archivos, red y entorno es intencional y auditable.
Solucionar problemas de flujos de trabajo DenoUsar comprobaciones nativas de Deno, banderas de depuración y herramientas de gráfico de módulos antes de adivinar.Muchos problemas de Deno son de configuración, permisos o propiedad, no errores de código.Cuando un repositorio híbrido o un conjunto de herramientas migrado se comporta inesperadamente.La causa raíz se reduce a configuración, permisos o comportamiento en tiempo de ejecución.

Reglas principales

TypeScript, tsconfig.json y bibliotecas

  • Colocar la configuración del compilador de Deno en deno.json bajo compilerOptions; no copiar un tsconfig.json completo de Node solo para que deno check funcione.
  • Los espacios de trabajo existentes de Node más TypeScript pueden mantener tsconfig.json; Deno lo explora cuando un directorio también contiene deno.json o package.json.
  • Si un deno.json padre define compilerOptions, estas tienen prioridad sobre las opciones superpuestas de tsconfig.json.
  • Si el objetivo es reemplazar tsc, primero inventariar el comportamiento actual de tsconfig.json. Preservar las decisiones significativas de rigor, resolución de módulos, JSX, bibliotecas, inclusiones y exclusiones en la configuración de Deno o documentar por qué ya no aplican.
  • Usar compilerOptions.lib en deno.json para modelar la superficie de tiempo de ejecución real. Para SSR o código de navegador más Deno, preferir combinaciones como ["dom", "dom.iterable", "dom.asynciterable", "deno.ns"]; para workers de Deno, preferir ["deno.worker"].
  • Usar compilerOptions.checkJs, // @ts-check, @ts-types, @ts-self-types o compilerOptions.types cuando los módulos JavaScript necesiten verificación de tipos o declaraciones explícitas.
  • Mantener tsconfig.json solo cuando las carpetas propiedad de Node, las referencias de proyecto TS o la granularidad de inclusiones o exclusiones aún lo requieran.

Linting, formateo y ESLint

  • Usar deno lint y la sección lint en deno.json como el propietario de linting predeterminado para el código propiedad de Deno.
  • Usar deno fmt y la sección fmt en deno.json como el formateador predeterminado para el código propiedad de Deno.
  • deno lint ya cubre un conjunto de reglas recomendado inspirado en ESLint; no mantener ESLint solo por costumbre.
  • Si el objetivo es reemplazar ESLint, primero inventariar el comportamiento actual de eslint.config.*. Preservar los ámbitos de archivo, globales, ignorados y la intención de las reglas significativas en la configuración de lint/fmt de Deno o documentar qué reglas se descartan intencionalmente porque Deno ya las cubre o rechaza.
  • Si se requieren reglas personalizadas solo para Deno, considerar lint.plugins; notar que la API de complementos de lint es experimental y requiere Deno 2.2 o más reciente.
  • Si el repositorio o el editor aún necesitan ESLint, convertirlo en una herramienta secundaria explícita: configurar nodeModulesDir: "auto", crear eslint.config.js y envolver la invocación en deno task, por ejemplo deno task eslint.
  • Mantener un propietario de lint por conjunto de archivos siempre que sea posible. Si tanto deno lint como ESLint se ejecutan en los mismos archivos, documentar por qué o esperar diagnósticos duplicados y conflictivos.

Compatibilidad con Node y repositorios híbridos

  • Deno 2 entiende package.json, node_modules, espacios de trabajo npm y módulos integrados de Node; los repositorios híbridos son una ruta compatible, no una solución alternativa.
  • El Node moderno también puede ejecutar TypeScript directamente. En repositorios híbridos, decidir la propiedad Node versus Deno según permisos, modelo de dependencias, ejecutor de tareas y destino de implementación, no solo por la ejecución de TypeScript.
  • Si existe un package.json y se desea que Deno cree y actualice automáticamente node_modules, configurar nodeModulesDir: "auto". Con package.json, Deno 2 por defecto usa "manual".
  • nodeModulesDir es una configuración a nivel de raíz del espacio de trabajo; no intentar configurarlo por miembro del espacio de trabajo.
  • Usar deno install o deno add cuando Deno sea el propietario del flujo de actualización de dependencias. No asumir el comportamiento de instalación automática de Deno 1.
  • Usar deno add --dev npm:<paquete> para CLI npm de solo desarrollo en repositorios propiedad de Deno. Después de agregarlo, exponer el binario a través de una deno task como "herramienta-ejemplo": "herramienta-ejemplo" en lugar de "herramienta-ejemplo": "deno run -A npm:herramienta-ejemplo".
  • Registrar en el repositorio las actualizaciones del manifiesto y el archivo de bloqueo producidas por deno add; un alias de tarea solo no es una instalación de dependencia.
  • No habilitar el conjunto de herramientas de Deno para todo un espacio de trabajo mixto si solo un subárbol es Deno.
  • Preferir la activación del editor basada en rutas como deno.enablePaths para que las herramientas de Node y Deno no compitan por los mismos archivos.
  • Mantener el límite de Deno explícito en la estructura de carpetas, tareas y documentación.

Permisos, entorno y seguridad

  • Preferir banderas --allow-* estrechas o conjuntos de permisos nombrados en deno.json sobre -A.
  • Usar -P o --permission-set=<nombre> cuando el repositorio defina conjuntos de permisos en deno.json.
  • Usar --env-file cuando la CLI deba cargar archivos .env, o @std/dotenv cuando el programa mismo necesite cargarlos; ambos aún necesitan permisos explícitos de entorno y archivos.
  • Preferir el mínimo privilegio para el código de aplicación y mantener el acceso al entorno, sistema de archivos, red y subprocesos obvio en tareas y ejemplos.
  • Tratar --allow-run y --allow-ffi como puertas de escape de la zona de pruebas. Evitar --allow-run=deno a menos que se intente explícitamente la confianza total.
  • Para depuración o auditoría de permisos, usar DENO_TRACE_PERMISSIONS=1 y DENO_AUDIT_PERMISSIONS=<ruta>.

Resolución de problemas y migración

  • Recurrir a deno check, deno check --all o deno run --check cuando el éxito en tiempo de ejecución y el comportamiento de verificación de tipos diverjan.
  • Usar deno info <punto_de_entrada> para inspeccionar el gráfico de módulos y comprender el comportamiento de importación, caché y permisos.
  • Usar deno lint --fix para la limpieza de migración común antes de editar manualmente cada problema de lint.
  • Para la configuración del depurador, usar --inspect-brk cuando el proceso sea de corta duración, --log-level=debug cuando el inspector o la resolución de módulos sea confusa, y --strace-ops cuando el tiempo de ejecución se esté colgando o sea inesperadamente lento.
  • Usar banderas de perfilado de CPU como --cpu-prof, --cpu-prof-md o --cpu-prof-flamegraph cuando la pregunta de resolución de problemas sea realmente sobre rendimiento.
  • Los consejos de migración deben reflejar los valores predeterminados de Deno 2: nodeModulesDir ahora usa "none" | "auto" | "manual", deno cache se convirtió en deno install --entrypoint, deno vendor se convirtió en "vendor": true, Deno.run() debe convertirse en new Deno.Command(), y Deno.serveHttp() debe convertirse en Deno.serve().
  • Usar atributos de importación como with { type: "json" } en lugar de aserciones de importación obsoletas.

Errores comunes

  • Si las herramientas de Deno y Node reclaman los mismos archivos, los diagnósticos del editor se vuelven ruidosos y engañosos.
  • Si existe package.json, Deno 2 establece nodeModulesDir en "manual" por defecto; olvidar esto es una razón común por la que las herramientas respaldadas por npm parecen medio instaladas.
  • Si la extensión ESLint de VS Code es parte del flujo de trabajo, no resolverá paquetes solo desde la caché global de Deno; necesita un directorio node_modules local.
  • deno run omite la verificación de tipos por defecto, por lo que una ejecución exitosa no es evidencia de que deno check pasará.
  • Una deno task que ejecuta deno run npm:<paquete> es un atajo de ejecución única, no una instalación de dependencia adecuada. No usarlo como la respuesta predeterminada a "instalar y configurar esta CLI" en un repositorio propiedad de Deno.
  • -A es aceptable para herramientas de confianza, pero es el valor predeterminado incorrecto para el código de aplicación ordinario.
  • Algunas CLI npm, incluyendo Supabase en repositorios reales de tiempo de ejecución mixto, dependen de comportamiento en tiempo de instalación que puede ser menos confiable a través de deno run npm:... que a través de un binario instalado bajo node_modules.
  • Los patrones antiguos de importación de URL y activación de todo el espacio de trabajo son ayudas de transición, no valores predeterminados modernos.

Validación

  • deno.json es propietario de la configuración y tareas de Deno.
  • Cualquier tsconfig.json o propiedad de ESLint retenido es explícito y está limitado a los archivos correctos.
  • Reemplazar ESLint o tsc preserva el comportamiento útil de la configuración existente o documenta por qué se descartó intencionalmente.
  • Las partes de Deno y Node de un repositorio híbrido no compiten por las herramientas.
  • Los especificadores de dependencia son modernos y explícitos.
  • Las CLI npm propiedad de Deno se agregan con deno add o deno add --dev, se registran en el manifiesto y el archivo de bloqueo, y se ejecutan a través de tareas que invocan nombres de binarios instalados.
  • nodeModulesDir, la activación del editor y cualquier herramienta Deno respaldada por npm se configuran intencionalmente.
  • Si una CLI npm se maneja desde tareas de Deno, el repositorio configura intencionalmente nodeModulesDir y allowScripts en lugar de depender de efectos secundarios de instalación accidentales.
  • Los permisos son intencionales y están documentados donde importan.
  • La guía de resolución de problemas comienza con comprobaciones nativas de Deno antes de recurrir a consejos genéricos de depuración de Node o TypeScript.

Referencias

…

[truncado para traducción]

Skills relacionados