Primeros pasos en 5 minutos

August 10, 2026 · View on GitHub

Idiomas: English · 中文

Esta ruta ofrece a los usuarios nuevos un inicio pequeño y práctico antes de leer toda la documentación del proyecto.

1. Instala Node.js si lo necesitas

La CLI de Skills.sh se ejecuta mediante npx, así que necesitas tener Node.js disponible:

node --version
npx --version

Si falta alguno de los comandos, instala Node.js con el gestor de paquetes de tu sistema operativo.

2. Elige tu agente y descarga los Skills

Instala todos los skills desde la entrada del registry de Skills.sh de este proyecto en el agente que uses con más frecuencia:

# Cursor
npx skills add jabrena/plinth --skill '*' --agent cursor -y

# Claude Code
npx skills add jabrena/plinth --skill '*' --agent claude-code -y

# Codex
npx skills add jabrena/plinth --skill '*' --agent codex -y

# GitHub Copilot
npx skills add jabrena/plinth --skill '*' --agent github-copilot -y

Para instalar en todos los agentes soportados, usa el modo multiagente de la CLI:

npx skills add jabrena/plinth --skill '*' --agent '*' -y

Para revisar primero los skills disponibles:

npx skills add jabrena/plinth --list

3. Instala los commands del proyecto

Después de instalar los skills, indica a tu agente qué AI agent harness usas: cursor, claude-code, codex o github-copilot.

install @004-commands-installation cursor
install @004-commands-installation claude-code
install @004-commands-installation codex
install @004-commands-installation github-copilot

El instalador copia los commands embebidos del proyecto en el directorio de commands de tu herramienta. Soporta destinos para Cursor, Claude, Codex y GitHub Copilot, y pregunta antes de escribir archivos.

Los destinos habituales para commands son:

  • .cursor/commands
  • .claude/commands
  • .codex/commands
  • .github/commands

4. Instala los agents del proyecto cuando tu herramienta los soporte

Commands y skills son suficientes para empezar. Si también quieres usar los robot agents predefinidos, indica a tu agente qué AI agent harness usas: cursor, claude-code, codex o github-copilot.

install @005-agents-installation cursor
install @005-agents-installation claude-code
install @005-agents-installation codex
install @005-agents-installation github-copilot

Los destinos habituales para agents son:

  • .cursor/agents
  • .claude/agents
  • .codex/agents
  • .github/agents

5. Usa el workflow

Este proyecto organiza el trabajo Java asistido por IA alrededor de cuatro bloques:

  • Commands son los puntos de entrada, como /onboarding, /update-issue, /create-spec y /implement-spec.
  • Agents definen responsabilidades, como análisis de negocio, arquitectura, liderazgo técnico, implementación Java o trabajo de rendimiento.
  • Skills aportan prácticas enfocadas para Java, frameworks, testing, documentación, seguridad y observabilidad.
  • MCP Servers conectan los agentes con herramientas externas y contexto del proyecto cuando están disponibles.

Una ruta habitual es:

/onboarding
  |
  v
Issue
  |
  v
/update-issue --> /explore-problem --> /create-acceptance-criteria
  |
  v
/create-spec --> /explore-design
  |
  v
/implement-spec --> /close-spec

Empieza con /onboarding para establecer AGENTS.md en la raíz y un único proyecto OpenSpec no ambiguo. Se conservan los prerrequisitos existentes. Si falta OpenSpec, selecciona su ruta resultante o acepta el valor predeterminado documentation/openspec.

Para trabajo solo de documentación o planificación, puedes detenerte cuando el issue, plan, especificación, ADR o diagrama esté completo.

Profundiza