ABSOLUTE-CLAUDE

Un solo comando bash. Todos los ahorradores de tokens y skills de UX/UI para Claude Code, cableados y listos. El OAuth de Figma es el único paso manual.

bash install.sh

Qué incluye

Componente	Qué hace	Fuente
RTK	CLI proxy en Rust que filtra y comprime la salida de comandos de shell antes de que llegue al LLM. Cablea un hook de Claude Code.	rtk-ai/rtk
Caveman	Plugin de modo terso, badge de statusline, middleware MCP caveman-shrink, fan-out multi-agente.	JuliusBrussee/caveman
Figma MCP	Servidor MCP remoto en https://mcp.figma.com/mcp, registrado con Claude Code. El OAuth es manual y basado en navegador.	Figma docs
skill ui-ux-pro-max	Skill propia de inteligencia de diseño UI/UX — 50+ estilos, 161 paletas de color, 57 combinaciones tipográficas, 161 tipos de producto y 99 guías de UX en 10 stacks. Consolida lo que antes eran skills separadas (frontend-design, brand-guidelines y taste), además de guía de motion (Framer Motion, GSAP). Incluida en este repo; no tiene repo upstream del que autoactualizarse.	propia (este repo)
21st.dev magic MCP	Generador de componentes en vivo de 21st.dev.	@21st-dev/magic (npx)
Framer Motion + GSAP	npm install --save framer-motion gsap en tu proyecto (se omite si no hay package.json).	framer-motion, GSAP
skill superpowers	Clonada en ~/.claude/skills/superpowers/. Paquete de meta-skills.	obra/superpowers
Skills de disciplina de ingeniería	Propias: architecture-principles (fusiona las antiguas skills solid, design-patterns y architecture-patterns en una sola skill SOLID → patrones GoF → arquitectura de sistemas) y conventional-commits.	este repo
rag	Vault V.A.U.L.T + RAG con PGVector (Docker) + Ollama bge-m3 + MCP rag (rag_query/rag_status).	propia (este repo)

Instalación

# Desde un clon de este repo:
bash install.sh

# O, una vez publicado, en una línea:
curl -fsSL https://raw.githubusercontent.com/Curcolor/CLAUDEMAX/main/install.sh | bash

Re-ejecutable. Idempotente. Pasa --dry-run para ver exactamente qué haría.

Flags

Flag	Efecto
--all	Instala todos los componentes (por defecto).
--only <id>	Solo un componente. Repetible. ids: rtk, caveman, figma, ui-ux, dev-skills, rag.
--skip <id>	Omite un componente. Repetible.
--no-npm	Omite npm install framer-motion gsap.
--with-npm	Fuerza el paso de npm aunque no haya package.json (ejecuta npm init -y).
--dry-run	Imprime cada comando. No toca nada.
--force	Reinstala componentes que se detectan a sí mismos como ya instalados.
--config-dir <path>	Sobrescribe $CLAUDE_CONFIG_DIR (por defecto ~/.claude).
--uninstall	Delega en uninstall.sh.
--no-color	Desactiva los colores ANSI.

Después de instalar

Solo quedan dos cosas, y una de ellas es simplemente reiniciar tu editor:

1. Reinicia Claude Code — los hooks y skills se cargan al inicio de la sesión.
2. Completa el OAuth de Figma: abre Claude Code, ejecuta /mcp, selecciona figma, completa el flujo en el navegador. ABSOLUTE-CLAUDE no guarda tokens de Figma. (Este es el único paso que no podemos automatizar — el OAuth requiere navegador.)
3. Prueba los comandos:
   • /caveman — activa el modo terso.
   • /superpowers — paquete de meta-skills (obra/superpowers).
   • architecture-principles, conventional-commits — skills de disciplina de ingeniería. Invócalas por nombre o deja que sus triggers se disparen automáticamente durante una revisión/refactor/commit.
   • ui-ux-pro-max — inteligencia de diseño UI/UX. Se dispara automáticamente en prompts de diseño/construcción/revisión que toquen UI, o pídela por nombre.

Inicio rápido de RAG

RAG_ROOT=<workspace-root> VAULT_MODE=create RAG_MODE=create bash install.sh --only rag
# luego:
cd <workspace-root>/R.A.G
node rag.mjs ingest          # indexa el vault
node rag.mjs query "..."     # búsqueda semántica (español o inglés)
node rag.mjs status

VAULT_MODE / RAG_MODE toman cada una uno de tres valores (por defecto create):

• create — vault nuevo / stack local nuevo de Docker Postgres+pgvector.
• import — trae un vault existente (VAULT_SRC=<folder>) o restaura un dump de BD (RAG_DUMP=<file>) en un stack recién creado.
• connect — apunta a un repo de vault existente (VAULT_REMOTE=<git url>) o a una instancia de Postgres existente (RAG_REMOTE_URL=<postgres://...>) en vez de crear uno nuevo.

Necesita Docker (para la BD local) y Ollama con bge-m3 descargado (para los embeddings) — el componente avisa y omite esos pasos si falta alguno, sin hacer fallar la instalación.

Formato Skills 2.0

Cada skill propia en skills/<name>/ incluye tres archivos:

skills/<name>/
├── SKILL.md      # frontmatter (name, description) para el descubrimiento de Claude Code + cuerpo en prosa
├── skill.yaml    # configuración estructurada: version, kind (knowledge|tool), triggers,
│                 # commands, scripts, dependencies, puntero a schema
└── schema.json   # JSON Schema (draft 2020-12) con definitions.inputs / definitions.outputs

Claude Code solo exige el frontmatter de SKILL.md; los archivos complementarios son una convención del repo que el modelo lee al invocarse y que el tooling consume como artefactos legibles por máquina. Valida todo el árbol con:

node skills/validate-skills.mjs

Desinstalación

bash uninstall.sh

Desmontaje simétrico. Deja los archivos por-repo (los archivos de reglas de Caveman escritos con --with-init, framer-motion/gsap en el node_modules de tu proyecto) para que los borres a mano.

Privacidad

Sin telemetría. El instalador no hace llamadas de analítica. Sí delega en:

• El script de instalación de rtk-ai/rtk (descarga el binario de rtk desde los releases de GitHub).
• npx -y github:JuliusBrussee/caveman (el instalador de Caveman descarga desde GitHub y npm).
• claude mcp add (CLI de Anthropic) para los registros MCP de Figma y 21st.dev magic.
• git clone para la skill superpowers (obra/superpowers). Las demás skills propias (architecture-principles, conventional-commits, ui-ux-pro-max) se copian directo desde este repo — sin llamadas de red.
• npm install framer-motion gsap en tu cwd (solo si existe un package.json o se pasa --with-npm).

Consulta bin/components/*.sh para ver cada línea de comando.

Alcance (qué es y qué no es esto)

• ✅ Instalador bash único, macOS / Linux / WSL / Git Bash en Windows.
• ✅ Nativo en Windows: RTK incluye un binario rtk.exe que el instalador descarga automáticamente cuando detecta MINGW/MSYS/Cygwin. Los MCPs (figma, magic) se registran a nivel de usuario para que funcionen en todos los proyectos.
• ✅ Idempotente, con dry-run, desinstalación quirúrgica.
• ❌ Sin instalador nativo de PowerShell para Windows (usa Git Bash — ya viene con Git for Windows).
• ❌ Sin almacenamiento de tokens de Figma. El OAuth se mantiene basado en navegador — este es el único paso manual.

---

Issues / PRs bienvenidos.