spanglish

Skill para que un agente hable como un dev hispano con algo de inglés.

Este plugin sigue Agent Plugins 1.0.0: plugin.json en la raíz y skills en skills/.

Quick start

Instala alguno de los plugins que aparecen más abajo.
Corre /spanglish-setup para escribir ~/.spanglish.json y dejar el hook configurado. Sin ese archivo el hook no inyecta nada.

Niveles

soft: inglés solo para conceptos 100% técnicos (PR, Git, hook)
mid: también anglicismos ambiguos (naming, casing, hardcodeado)

La preferencia vive en ~/.spanglish.json (home del usuario, no el repo). El level se configura con /spanglish-setup. Los overrides de una session se guardan con /persist-spanglish-overrides.

Agregar este repo en Cursor

Este plugin no está en el Cursor Marketplace público. Lo instalas desde el Git repo.

URL: https://github.com/naquiroz/spanglish

Para más detalle, consulta Plugins.

Pegar la URL en Customize

Cursor instala un plugin si pegas la URL del repo en la búsqueda.

Abre Customize en la barra lateral.
Pega https://github.com/naquiroz/spanglish en la búsqueda de plugins.
Install y elige alcance de proyecto o de usuario.

Registrar el marketplace en el CLI

Para dejar el repo como fuente de plugins, no solo un install puntual:

agent plugin marketplace add https://github.com/naquiroz/spanglish

Pinnea branch, tag o commit con --git-ref. En una session del CLI, /plugin marketplace add acepta la misma URL.

Instala el plugin desde Customize.

Marketplace de equipo

Ve a Dashboard → Plugins.
En Team Marketplaces, Add Marketplace.
Crea uno desde cero, o Import from Repo con la URL de GitHub.
Revisa los plugins con Add to Marketplace.
En Marketplace Settings, define Marketplace Access. Opcional: Enable Auto Refresh. Guarda.

Puedes verlo en Customize e instalarlo ahí.

Activar el hook para usar la skill en automático

El hook sessionStart activa la skill spanglish al arrancar la conversación. Inyecta ~/.spanglish.json. Sin el hook, hay que invocar /spanglish a mano.

Es una extensión de cliente (com.cursor/, com.anthropic.claude/, com.openai.codex/), no un componente portable de Agent Plugins. Setup no toca ~/.cursor/hooks.json.

Necesitas python3. Si no existe ~/.spanglish.json, el hook no inyecta nada: corre /spanglish-setup una vez.

Cursor

mkdir -p ~/.cursor/plugins/local
ln -s https://github.com/naquiroz/spanglish ~/.cursor/plugins/local/spanglish

Recarga la ventana: Developer: Reload Window.

Docs: Plugins.

Claude Code

Una session:

claude --plugin-dir https://github.com/naquiroz/spanglish

Para dejarlo instalado:

claude plugin marketplace add https://github.com/naquiroz/spanglish
claude plugin install spanglish@spanglish

O en el chat: /plugin marketplace add con https://github.com/naquiroz/spanglish, luego /plugin install spanglish@spanglish. Abre una conversación nueva. Si el hook no corre desde el marketplace, usa --plugin-dir.

Codex

codex plugin marketplace add https://github.com/naquiroz/spanglish
codex plugin add spanglish@spanglish

En la CLI, /hooks y trust el hook. Codex no corre plugin hooks hasta que los revisas.

Si tu Codex no carga hooks del plugin, pon esto en ~/.codex/hooks.json. Si el archivo ya existe, mergea el bloque SessionStart. Cambia /ruta/al/spanglish por la ruta absoluta del clone:

{
  "description": "Injects spanglish config from ~/.spanglish.json at session start",
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"/ruta/al/spanglish/scripts/spanglish-session-start\""
          }
        ]
      }
    ]
  }
}

Después /hooks y trust.

Uso

Con el hook activo, la skill corre sola. Si no, invoca /spanglish, o pide "háblame en spanglish".

Estructura

plugin.json
skills/
scripts/spanglish-session-start
com.cursor/hooks/
com.anthropic.claude/hooks/
com.openai.codex/hooks/

plugin.json — manifiesto Agent Plugins
skills/ — skills portables
com.cursor/hooks/ — hook Cursor
com.anthropic.claude/hooks/ — hook Claude Code
com.openai.codex/hooks/ — hook Codex
.cursor-plugin/ / .claude-plugin/ / .codex-plugin/ — manifiestos nativos para que esos clientes carguen el hook