CommunityImagengithub.com

ucoz-skills/agent-skills

Biblioteca oficial de habilidades para agentes de uCoz y plugin MCP para asistentes de codificación con IA.

¿Qué es agent-skills?

Esta es la biblioteca oficial de habilidades para agentes (Agent Skills) de uCoz, diseñada para asistentes de codificación con IA como Cursor, Codex, Antigravity, Hermes y Claude Code. Proporciona un conjunto de habilidades que permiten a los agentes interactuar con la plataforma uCoz para tareas como la generación y edición de páginas de aterrizaje, el aprovisionamiento de sitios, la configuración de MCP (uAPI, FTP, módulos) y la gestión de campañas publicitarias. Cada habilidad se distribuye junto con el servidor `ucoz-mcp`, que expone herramientas como `templates_tool`, `ftp_tool` y `modules_tool` para manipular plantillas, archivos y módulos del sitio. El repositorio incluye instrucciones de instalación detalladas para múltiples plataformas, soporte para plugins nativos y configuración de variables de entorno como `UCOZ_API_TOKEN`, `UCOZ_SITE_URL`, `UCOZ_FTP_HOST`, `UCOZ_FTP_USER` y `UCOZ_FTP_PASS`.

Compatible con✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/ucoz-skills/agent-skills/tree/main

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

agent-skills preview

Documentación

Habilidades para Agentes de uCoz

Agent Skills oficiales para agentes de IA que trabajan con uCoz: páginas de aterrizaje, aprovisionamiento de sitios, campañas publicitarias.

Cada habilidad incluye el servidor ucoz-mcp: instala el plugin una vez y obtén tanto las instrucciones como las herramientas.

Catálogo web: ucoz.com/ai/skills
Documentación MCP: api.ucoz.net/mcp

Habilidades disponibles

HabilidadDescripciónVersión
ucoz-landing-skillGenera y edita páginas de aterrizaje mediante MCP1.3
ucoz-provisioning-skillCrea o conecta un sitio uCoz y configura MCP (uAPI, FTP, módulos). Requiere Playwright — ver browser-runner1.1

Instalación

Cursor (habilidades + MCP)

Instala desde GitHub — las habilidades y MCP se configuran juntos mediante .cursor-plugin/plugin.json:

Configuración → Reglas → Nueva regla → Añadir desde Github → https://github.com/ucoz-skills/agent-skills.git

O envía el repositorio en cursor.directory/plugins/new.

Después de instalar, abre Configuración → Herramientas y MCP y configura las variables de entorno para ucoz-mcp (consulta Configuración MCP).

Codex (habilidades + MCP)

Codex App — instala el plugin de uCoz desde el catálogo de plugins.

Codex CLI — ejecuta /plugins, selecciona uCoz y elige Instalar plugin.

Las habilidades se cargan desde skills/; la configuración MCP se lee de .mcp.json mediante .codex-plugin/plugin.json. Configura las variables de entorno de uCoz en los ajustes de MCP de Codex (consulta Configuración MCP).

Antigravity (IDE + CLI)

Google Antigravity descubre las habilidades desde skills/ y es compatible con MCP empaquetado mediante plugins nativos (plugin.json + mcp_config.json).

Antigravity CLI — instalación de plugin (recomendado, habilidades + MCP):

agy plugin install https://github.com/ucoz-skills/agent-skills.git

Instala globalmente en ~/.gemini/config/plugins/ucoz/. Verifica con agy plugin list y navega por las habilidades con /skills en la CLI.

Antigravity IDE — CLI de habilidades:

npx skills add ucoz-skills/agent-skills

Instala las carpetas de habilidades en ~/.agents/skills/ (detectadas por Antigravity IDE). Para compartir habilidades entre todas las herramientas de Antigravity, cópialas a ~/.gemini/skills/ en su lugar; consulta la documentación de habilidades de Antigravity.

Instalación solo en el espacio de trabajo — copia las carpetas de habilidades en .agents/skills/ en la raíz de tu proyecto.

Después de instalar, configura las variables de entorno UCOZ_* para MCP (consulta Configuración MCP). Cuando uses la ruta del plugin, MCP se empaqueta desde mcp_config.json; de lo contrario, fusiona ese archivo en ~/.gemini/config/mcp_config.json.

Valida un clon local antes de instalar:

agy plugin validate /path/to/agent-skills

Hermes (Skills Hub)

Hermes Agent descubre habilidades desde taps de GitHub y el índice skills.sh.

Suscríbete al repositorio (tap personalizado):

hermes skills tap add ucoz-skills/agent-skills

Instalar habilidades:

hermes skills install ucoz-skills/agent-skills/skills/ucoz-landing-skill
hermes skills install ucoz-skills/agent-skills/skills/ucoz-provisioning-skill

CLI de habilidades (también registra el repositorio con la telemetría de skills.sh para la indexación del catálogo):

npx skills add ucoz-skills/agent-skills

Después de la primera instalación, las habilidades aparecen en skills.sh/ucoz-skills/agent-skills y en el índice de Hermes Skills Hub (se actualiza periódicamente). Actualizaciones: haz push a GitHub; los usuarios ejecutan hermes skills check y hermes skills update.

Hermes usa la API de GitHub para navegar por los taps. Configura GITHUB_TOKEN en ~/.hermes/.env (o ejecuta gh auth login) si alcanzas los límites de tasa de la API.

Claude Code (marketplace)

/plugin marketplace add ucoz-skills/agent-skills
/plugin install ucoz@ucoz-skills

Las habilidades se cargan desde skills/; la configuración MCP se lee de .mcp.json en la raíz del plugin.

CLI de habilidades (solo habilidades)

npx skills add ucoz-skills/agent-skills

Instala una sola habilidad:

npx skills add ucoz-skills/agent-skills --skill ucoz-landing-skill
npx skills add ucoz-skills/agent-skills --skill ucoz-provisioning-skill

La CLI de habilidades solo instala las instrucciones. Añade .mcp.json a tu proyecto o IDE por separado para las herramientas MCP.

Instalación manual

Copia una carpeta de habilidad en tu directorio de habilidades del agente:

  • skills/ucoz-landing-skill
  • skills/ucoz-provisioning-skill (incluye browser-runner/ para aprovisionamiento con Playwright)
HerramientaRuta de habilidades
Cursor.cursor/skills/ o .agents/skills/
Claude Code.claude/skills/
Antigravity.agents/skills/ (espacio de trabajo) o ~/.gemini/skills/ (global)

Configuración MCP

El repositorio incluye .mcp.json — se empaqueta automáticamente al instalar el plugin de Cursor, Codex, Claude Code o Antigravity.

MCP se ejecuta mediante stdio:

npx -y ucoz-mcp@latest

Configura estas variables de entorno en los ajustes MCP de tu IDE:

VariableDescripción
UCOZ_API_TOKENToken de uAPI desde el panel de control
UCOZ_SITE_URLURL del sitio, p. ej. https://ejemplo.ucoz.net/
UCOZ_FTP_HOSTHost FTP
UCOZ_FTP_USERNombre de usuario FTP
UCOZ_FTP_PASSContraseña FTP

Ejemplo de configuración MCP (también en .mcp.json y mcp_config.json):

{
  "mcpServers": {
    "ucoz-mcp": {
      "command": "npx",
      "args": ["-y", "ucoz-mcp@latest"],
      "env": {
        "UCOZ_API_TOKEN": "tu-token",
        "UCOZ_SITE_URL": "https://tu-sitio.ucoz.net/",
        "UCOZ_FTP_HOST": "tu-sitio.ucoz.net",
        "UCOZ_FTP_USER": "tu-login-ftp",
        "UCOZ_FTP_PASS": "tu-contraseña-ftp"
      }
    }
  }
}

Herramientas MCP

HerramientaPropósito
templates_toolPlantillas de página, menús, formularios de correo, copias de seguridad
ftp_toolSubir CSS/JS/imágenes, gestionar archivos del sitio
modules_toolInstalar módulos, cuarentena/indexación

Licencia

MIT — consulta LICENSE.

Skills relacionados