convez.ai
SkillProdutividadeIntermediário
fabianmelomaciel

SkillGrid

fabianmelomaciel/SkillGrid

31 skills para potencializar seu copiloto de IA em desenvolvimento

Ver no GitHub
InicialPluginScore · de 0 a 100

Coleção de 31 skills portáveis que transformam assistentes de IA em equipes de desenvolvimento especializadas. Inclui reparo automático de erros, memória persistente, controle de segurança e instalação modular por roles. Funciona com Claude, Cursor, Copilot e plataformas abertas.

Instalação

$npx convez-ai fabianmelomaciel/SkillGrid

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v1.29.0
Issues abertas
3
Contribuidores
2

Casos de uso

  • Automatizar ciclos de depuração e reparo de código
  • Implementar agentes especializados por função (DevOps, Design, Marketing)
  • Estender capacidades de assistentes de IA com instruções estruturadas

Veredito

SkillGrid oferece uma abordagem estruturada para potencializar agentes de IA com skills modularizadas e instalação simplificada. Útil para equipes que querem automação consistente, embora requeira familiaridade com scripting e conceitos de agents.

README

A tradução para o português deste README ainda está na fila.

El copiloto de IA que trabaja con tu cabeza, no en contra.

31 skills especializadas para opencode · antigravity · Claude Code · Cursor · Copilot

License: MIT Skills PRs Welcome GitHub stars GitHub forks GitHub contributors

⚡ ¡Acelera tu Agente en 10 Segundos! ⚡


¿Qué es SkillGrid?

SkillGrid es una colección de skills portables — instrucciones estructuradas que transforman tu asistente de IA en un equipo de desarrollo especializado de primer nivel. Cada skill le enseña al agente exactamente cuándo activarse, qué hacer y cuándo detenerse para lograr el resultado óptimo.

No es solo una lista de prompts. Es un sistema de trabajo autónomo y eficiente que incluye:

  • 🔁 Bucle de Reparación Automática — Ahorra horas de depuración. Tus agentes auditan y corrigen fallos en ciclos autónomos cerrados.
  • 🧠 Memoria Persistente (CODEX) — Cero fricción en contexto. El agente aprende los secretos de tu proyecto y nunca te hace repetir explicaciones.
  • 🛡️ Seguridad Bajo Control (Taxonomía de Riesgo) — Duerme tranquilo. El agente sabe qué cambios aplicar de forma segura y cuándo pedir tu autorización.
  • 📦 Instalación Modular por Roles — Descarga solo lo que tu equipo necesita (DevOps, Diseño, Gestión, Marketing).

⚡ Instalación en 10 segundos

El instalador detecta automáticamente opencode, antigravity, Claude Code y demás — y los configura todos de una vez. Por defecto instala el perfil minimal para reducir tokens/contexto.

Windows (PowerShell)

irm https://raw.githubusercontent.com/fabianmelomaciel/SkillGrid/main/remote-install.ps1 | iex

Perfil (opcional):

$env:SKILLGRID_PROFILE="minimal"
irm https://raw.githubusercontent.com/fabianmelomaciel/SkillGrid/main/remote-install.ps1 | iex

Nota: el instalador remoto clona una versión fija por seguridad. Si esa versión todavía no soporta perfiles, el valor se ignora automáticamente. Para asegurar perfiles, clonar y ejecutar localmente.

Linux / macOS (bash)

curl -fsSL https://raw.githubusercontent.com/fabianmelomaciel/SkillGrid/main/remote-install.sh | bash

Perfil (opcional):

SKILLGRID_PROFILE=minimal curl -fsSL https://raw.githubusercontent.com/fabianmelomaciel/SkillGrid/main/remote-install.sh | bash

Nota: el instalador remoto clona una versión fija por seguridad. Si esa versión todavía no soporta perfiles, el valor se ignora automáticamente. Para asegurar perfiles, clonar y ejecutar localmente.

Eso es todo. El instalador detecta tu setup y copia las skills donde corresponde. ✅


🛠️ Instalación avanzada

# Windows
git clone https://github.com/fabianmelomaciel/SkillGrid.git C:\SkillGrid
cd C:\SkillGrid
.\install.ps1 -Profile minimal
# Linux / macOS
git clone https://github.com/fabianmelomaciel/SkillGrid.git ~/skillgrid
cd ~/skillgrid && bash install.sh --profile minimal
PerfilEnfoqueCuándo usar
minimalGates mínimosPrincipiantes, sesiones cortas, cambios pequeños
standardFlujo completoDesarrollo normal día a día
testingQA & E2EEquipos de QA — solo 4 skills, ~8K tokens
strictSuite completaAuditorías y hardening (más pesado)
allTodoSólo si sabés que lo necesitás

Cómo entenderlo (para nuevos):

  • Un perfil es la “cantidad de roles” que cargás. Menos roles = menos contexto, menos ruido y menos consumo.
  • Si tu tarea es normal (feature/bugfix), empezá en minimal o standard.
  • Si te piden auditoría completa (seguridad/marketing/finops) o coordinación total, usá strict o all.

Cambiar de perfil (reinstalar encima):

.\install.ps1 -Profile minimal|standard|strict|all
./install.sh --profile minimal|standard|strict|all

Nota sobre "cantidad de carpetas" instaladas:

  • El repo tiene 31 skills. Además se instalan shared/ y bundles/ (soporte, no cuentan como skill).
  • Si ven más carpetas, suele ser por restos de instalaciones anteriores (por ejemplo core/, design/, template/). Podés borrarlas manualmente y reinstalar el perfil elegido.

Chequeo antes de instalar (recomendado):

npm test
node scripts/install-tasks.js token-audit .

Genera automáticamente .cursor/rules/ y .github/instructions/ con las reglas del lenguaje de tu proyecto:

# Windows — autodetecta el lenguaje del proyecto
.\install.ps1 -ProjectDir "C:\ruta\a\tu-proyecto"

# Forzar lenguaje específico
.\install.ps1 -ProjectDir "C:\ruta\a\tu-proyecto" -Language php
# Linux / macOS
./install.sh --project "/ruta/a/tu-proyecto"
./install.sh --project "/ruta/a/tu-proyecto" --language python
HerramientaSoporteRuta de instalación
opencode✅ Automático~/.config/opencode/skills/
antigravity✅ Automático~/.gemini/config/skills/
Claude Code✅ Automático~/.claude/skills/
Cursor IDE✅ Via -ProjectDir.cursor/rules/*.mdc
GitHub Copilot✅ Via -ProjectDir.github/instructions/*.md
Aider⚙️ Manualaider --instructions-file skills/.../SKILL.md

🗺️ Skills incluidas

🔧 Core — Metodología de desarrollo

Las 20 skills que convierten a tu agente en un ingeniero de software disciplinado:

SkillCuándo la usas
brainstormingAntes de tocar código — diseña la feature primero
changelog-generatorGenera notas de lanzamiento automatizadas analizando el historial de Git
spec-driven-developmentCuando los requerimientos son vagos o ambiguos
writing-plansPara planificar cambios que tocan múltiples archivos
incremental-implementationPara entregar en rebanadas seguras y revisables
playwright-testingDiseñar, escribir y optimizar pruebas E2E y de componente con Playwright
test-driven-developmentRed → Green → Refactor con disciplina real
systematic-debuggingCuando algo falla y no sabés por qué
code-simplificationRefactorizar sin cambiar comportamiento
verification-before-completionAntes de decir "está listo" — evidencia concreta
context-engineeringCuando el agente empieza a alucinar por context flooding
db-schema-detectorDetecta bases de datos locales y genera esquemas cached en CodeGraph para ahorrar tokens
dispatching-parallel-agents2+ tareas independientes — lanzalas en paralelo
subagent-driven-developmentEjecutar planes grandes con subagentes especializados
requesting-code-reviewAntes de mergear — checklist + evidencia
receiving-code-reviewCuando recibís feedback — no aplicar a ciegas
finishing-a-development-branchCerrar ramas: merge, PR, o cleanup
using-git-worktreesAislar features para no romper el workspace
writing-skillsCrear y testear tus propias skills
executing-plansEjecutar planes por lotes con checkpoints de revisión

🎨 Design Engineering — Calidad visual premium

SkillQué hace
impeccable-design-tasteAuditoría de diseño en 6 capas: tipografía, color, espaciado, polish, motion y accesibilidad WCAG AA. Detecta y elimina los "AI tells" (glassmorphism genérico, gradients de AI, cards idénticas).
emil-kowalski-designAnimaciones ≤300ms, micro-interacciones, perceived performance. Principios de diseño de Emil Kowalski aplicados sistemáticamente.
creativo-visualDirector Creativo y Diseñador Visual. Traduce prompts básicos a especificaciones artísticas de 5 componentes (Subject, Action, Context, Composition, Style) e integra ImageMagick.

🤖 Agentes especializados

Agentes que se comportan como profesionales con roles definidos:

AgenteRol
auditor-de-seguridadEscanea 12 categorías: secrets, dependencias, SAST (OWASP Top 10), rate limiting, auth, API security, encryption, logging, compliance, infra, DB y CI/CD
audit-loopFollow-up de auditorías. Clasifica hallazgos, aplica fixes seguros automáticamente, pide OK para los sensibles, re-audita hasta 3 veces
agente-devopsDiseña y audita Dockerfiles y pipelines CI/CD seguros. Alineado con IEEE 730 e ISO 27001
agente-ideasDeliberación y consenso. Resuelve decisiones complejas o ambiguas con un consejo de 3 etapas optimizado: Complexity Gate (evalúa si vale la pena), Early-Exit Gate (salta revisión si hay convergencia) y Chairman-driven synthesis — mínimo gasto de tokens
auditor-de-marketingAudita SEO on-page, schema markup, AEO/GEO, programmatic SEO, AI writing (30 patrones), copy quality, OpenGraph, readability y CRO
optimizador-finopsAnaliza consumo de tokens, comprime prompts, detecta llamadas redundantes a APIs
project-managerEscucha al CEO, planifica, delega a agentes especializados, revisa resultados y reporta
gestor-documentalFormatea documentación técnica y académica (APA 7ª ed., ISO 29148, ISO 29119)

🎁 Bundles por rol

Instala solo lo que necesita tu equipo:

BundleQué incluye
coreLas 20 skills de metodología de desarrollo
devopsagente-devops · audit-loop · auditor-de-seguridad · optimizador-finops
designimpeccable-design-taste · emil-kowalski-design · creativo-visual
testingplaywright-testing · test-driven-development · systematic-debugging · verification-before-completion
managementproject-manager · gestor-documental · audit-loop · agente-ideas
marketingauditor-de-marketing

⚡ Workflows multi-skill

Combinaciones pre-diseñadas para tareas complejas:

WorkflowSecuencia
Feature completabrainstorming → spec-driven-development → writing-plans → incremental-implementation → requesting-code-review → finishing-a-development-branch
Feature con E2Ebrainstorming → spec-driven-development → writing-plans → test-driven-development → incremental-implementation → playwright-testing → requesting-code-review → finishing-a-development-branch
Auditoría + reparaciónauditor-de-seguridad → audit-loop
Deploy seguroagente-devops → auditor-de-seguridad → audit-loop
Rediseño UIbrainstorming → impeccable-design-taste → emil-kowalski-design → incremental-implementation
Auditoría completaauditor-de-seguridad + auditor-de-marketing + optimizador-finops (paralelo) → gestor-documental

🧪 v1.5 "Security & Intelligence" (2026-06-10)

New Skills & Models

  • playwright-testing: Nueva skill E2E integrada en bundle core y nuevo bundle/perfil testing (4 skills, ~8K tokens).
  • models.json: 3 modelos nuevos — gemini-2.5-flash, claude-sonnet-4.6-thinking, o4-mini con quirks, anti_patterns y precios reales.

Security

  • ralph-loop.ps1 / ralph-loop.sh: Security gate — whitelist de agentes permitidos (claude, opencode, antigravity-ide, antigravity, aider, gemini). Previene ejecución arbitraria de comandos.

DX & Tooling

  • generate-catalog.js: Auto-sync de skills/index.json al correr npm run catalog. Previene desincronización futura entre catalog.json e index.json.
  • README: Workflow "Feature con E2E" agregado. Perfil testing documentado en tablas.

🧪 v1.4 "Token-Efficient Deliberation" (2026-06-08)

Token Optimization

  • agente-ideas: −42% tokens (1,101→633). Nuevo Complexity Gate (evalúa si vale la pena convocar consejo), Early-Exit Gate (salta Stage 2 si hay convergencia) y Stage 2 rediseñado (Chairman-driven, elimina 3 LLM calls por deliberación). Tools legacy corregidos a nombres reales de opencode (task, read, glob, grep, edit, write, bash).
  • project-manager: −69% tokens (3,354→1,030). Session Handoff compacto, Database Change Management comprimido, Dual-Environment Analysis comprimido, Tools corregidos. Shared refs restauradas (existen en skills/shared/).
  • db-schema-detector: Tools legacy corregidos (run_command→bash, view_file→read, write_to_file→edit/write).
  • openskills bundle: agente-ideas añadido a la distribución para plataforma antigravity.
  • README: Descripciones actualizadas, tabla de idiomas corregida.

🧪 v1.3 "Full Audit & Hardening" (2026-06-07)

Security Hardening

  • Installer safety: remote-install.ps1 and remote-install.sh pinned to --branch v1.0.0 to prevent supply-chain attacks
  • rm -rf guard: Added confirmation prompt in install.sh before any destructive operation
  • Dependency lock: package-lock.json generated to freeze dependency tree
  • CI/CD tracking restored: .github/workflows/ removed from .gitignore — pipelines now tracked in version control

Bugfixes

  • workflows.md: Fixed typo imperfectable → impeccable
  • gestor-documental/SKILL.md: Sections 3 and 4 swapped to correct logical order
  • auditor-de-seguridad/SKILL.md: Added missing verification-gate.md to shared protocol references
  • session-controls.md: Now documents SKILLGRID_SCRATCH env var

Maintainability

  • DRY reporting: scripts/report-common.ps1 created — shared Escape-Html function used by audit.ps1 and generate-report-from-json.ps1
  • Inline JS externalized: scripts/install-tasks.js extracted from install.ps1 (~739→~557 lines)
  • Parallel scanners: All 12 security scanners in audit.ps1 now run via Start-Job for PowerShell 5.1
  • Install profiles: minimal/standard/strict profiles via -Profile flag
  • Header normalization: stack-detection.md header # → ##

Content Improvements

  • AI writing patterns: 30 detection patterns extracted from auditor-de-marketing/SKILL.md to references/ai-writing-patterns.md — SKILL.md reduced by ~44 lines
  • CODEX Learning Loop: Enhanced from 7-line stub to actionable guide (when to log, quality standards, format)
  • Chesterton's Fence deduplicated: Cross-referenced between anti-rationalization.md, code-simplification, and auditor-de-seguridad
  • Session controls referenced: session-controls.md linked from context-engineering and project-manager footers

🚀 Quick Start Examples

Ejemplos de conversaciones reales con tu agente usando SkillGrid:

Feature completa (de principio a fin)

Tú: "Agrega un modo oscuro a mi app React"
  → brainstorming activa → define alcance, trade-offs, UX
  → spec-driven-development → documenta requerimientos
  → writing-plans → descompone en tareas verticales
  → incremental-implementation → implementa slice por slice
  → requesting-code-review → checklist antes de mergear
  → finishing-a-development-branch → decide merge/PR/cleanup

Auditoría de seguridad + reparación automática

Tú: "Audita la seguridad del proyecto"
  → auditor-de-seguridad → escanea 12 categorías (secrets, SAST, OWASP, etc.)
  → audit-loop → clasifica findings: 🟢 auto-fix, 🟡 requiere OK, 🔴 no tocar
  → CEO revisa plan → audit-loop ejecuta fixes seguros
  → Re-audita hasta 3 iteraciones o hasta que pase

Marketing + SEO completo

Tú: "Audita el SEO y marketing del sitio"
  → auditor-de-marketing → 9 categorías: schema, AEO/GEO, programmatic SEO,
    AI writing (30 patrones), copy quality, CRO, OpenGraph, readability
  → audit-loop → repara meta tags, schemas, OpenGraph automáticamente
  → Genera dashboard HTML interactivo con scores y recomendaciones

Assets visuales + diseño UI

Tú: "Necesito favicon, OG image y rediseñar la landing"
  → creativo-visual → genera favicon multi-resolución, OG 1200×630,
    PWA manifest, emoji suggestions, auto-integración con framework
  → impeccable-design-taste → audita tipografía, color, espaciado, WCAG
  → emil-kowalski-design → animaciones ≤300ms, micro-interacciones

Decisión arquitectónica compleja

Tú: "¿Debo migrar de REST a GraphQL?"
  → agente-ideas → Fan-out (Pragmatic, Security, Performance)
  → Peer Review anónimo → Chairman sintetiza
  → project-manager ejecuta el plan aprobado por CEO

🧠 Sistema CODEX — Memoria persistente del agente

Cada instalación genera un archivo CODEX.md local y privado (en .gitignore). Es la memoria de largo plazo del agente:

SecciónPara qué sirve
🎯 Project ContextStack, DB, directorios, deployment — el agente no te vuelve a preguntar
💡 Token Economy RulesReglas de eficiencia: sin preámbulos, output compacto, verificación inmediata
🏗️ Active Design SystemPaleta, tipografía, radios — consistencia visual garantizada
🛠️ Technical GotchasQuirks del entorno, reglas del proyecto descubiertas en el camino
💻 Mission LogsHistorial de decisiones y soluciones — el agente aprende de cada sesión

El instalador nunca sobreescribe tu CODEX.md si ya existe. Tu memoria acumulada está 100% protegida.


📊 Dashboards visuales de reportes

Los agentes de análisis generan dashboards HTML interactivos con dark mode, glassmorphism y animaciones — se abren directo en tu navegador:

  • 🔒 Security Dashboard — vulnerabilidades por categoría, acordeones interactivos, bloques de código vulnerables
  • 💰 FinOps Dashboard — ahorro de tokens estimado, redundancias, propuestas de refactor copiables
  • 🚀 DevOps Dashboard — SCM Quality Score, validación de Dockerfiles y Compose, scaffolding seguro listo para usar
  • 📢 Marketing Dashboard — SEO score, estado de OpenGraph, análisis de CTAs above/below the fold

📈 Ahorro Masivo de Tokens con CodeGraph + Protocolos SkillGrid

SkillGrid combina CodeGraph (indexación semántica local) con protocolos de eficiencia (Chesterton's Fence, Verify Before Refactor, DRY enforcement, Dual-Environment) para eliminar el consumo innecesario de tokens. Olvídate de que tu agente lea archivos completos una y otra vez o proponga cambios que no deberían hacerse.

🚀 Principales Beneficios y Políticas de Eficiencia

  • Hasta 95% de Ahorro en Tokens: CodeGraph reduce el contexto −89.5%. Los protocolos de SkillGrid evitan además el desperdicio en falsos positivos y refactors innecesarios, alcanzando hasta −95% combinado.
  • Cero Fricción (Auto-Sincronización): Se instala y sincroniza en segundo plano automáticamente. El agente siempre tiene un mapa actualizado de tu codebase sin que tengas que mover un dedo.
  • Refactorización Inteligente de Archivos Largos (Regla Crítica):
    • Si un archivo supera las 300 líneas o es modificado/leído repetidamente (más de 2-3 veces en una misma sesión), el agente tiene la directriz estricta de refactorizar y subdividirlo en submódulos o helpers pequeños.
    • Esto garantiza que futuras lecturas requieran fragmentos mínimos de contexto, optimizando el presupuesto de tokens.
    • Tras cualquier refactorización, se fuerza la auto-sincronización (codegraph sync) para mantener el mapa de dependencias y código actualizado.
  • Respuestas Inmediatas: Al evitar el "context flooding" en el prompt, tu asistente de IA responde mucho más rápido y con mayor precisión (evitando alucinaciones).
  • Control de Costos (FinOps): Compara el consumo de tokens y visualiza tu ahorro acumulado en tiempo real desde tu propio dashboard local.

📊 Comparativa Real de Consumo y Costos por Plataforma

Medido el 2026-06-04 sobre 300 archivos (~1.47 MB de código fuente):

MétricaFull Scan (sin CodeGraph)Con CodeGraphReducción
Tokens de contexto368,29838,830−89.5%
Plataforma / HerramientaModeloCosto Full ScanCosto con CodeGraphAhorro CodeGraph
opencodeClaude Sonnet 4.6$0.921$0.09789.5%
opencodeDeepSeek V4 Flash$0.184$0.01989.5%
AntigravityGemini 1.5 Flash$0.028$0.00389.5%
Antigravity / CursorGemini 1.5 Pro$0.460$0.04989.5%
Antigravity IDEGemini 2.5 Pro$0.460$0.04989.5%
Claude CodeClaude 3.5 Sonnet$1.105$0.11689.5%
Cursor IDEGPT-4o / Claude 3.5$0.921$0.09789.5%
GitHub CopilotGPT-4o$0.921$0.09789.5%
Open WebUIMulti-modelvariablevariable≥89.5%

[!NOTE] ¿Por qué Gemini ahorra aún más? Con Gemini (Google), el beneficio es doble: al reducir el contexto por debajo del límite de 128K tokens, la tarifa por millón de tokens se reduce a la mitad. ¡Menos tokens a un precio unitario inferior!

📉 Ahorro Adicional por Protocolos de SkillGrid

Además del −89.5% de CodeGraph, los protocolos de SkillGrid evitan tokens desperdiciados en falsos positivos, refactors innecesarios y duplicación. Estimaciones basadas en mediciones de sesiones reales:

Protocolo / ReglaAhorro adicional estimadoCómo evita desperdicio de tokens
Chesterton's Fence (auditor no propone refactor innecesario)−50% a −80% en hallazgos falsosCada falso positivo evitado = 500–2,000 tokens que no se gastan en planificar + implementar + revisar
Verify Before Refactor Gate (verificar antes de sugerir cambios)−30% a −60% en ciclos de reparaciónEl audit-loop ya no itera sobre cambios que no deberían hacerse
DRY Enforcement (no duplicar código)−10% a −20% en código generadoSe reusa código existente en vez de crear desde cero
Dual-Environment Protocol (localhost vs producción)−15% a −30% en sugerencias inválidasNo se proponen cambios que romperían en producción ni se discuten archivos environment-específicos
Idioma del skill adaptado (inglés o español según el agente)−5% a −10% por skill cargadaSkills en inglés (~15–20% más compacto) donde aplica; skills en español para equipos hispanohablantes. Detectado automáticamente por project-manager
Context Engineering (working set + sin re-lecturas completas)−20% a −40% en exploraciónNo se releen archivos completos "para recordar"

Ahorro combinado total estimado: entre −92% y −95% versus un agente sin SkillGrid ni CodeGraph.

⚡ Ejemplo real: Una auditoría de seguridad completa (12 categorías) que antes consumía ~50,000 tokens ahora consume ~4,000–8,000 tokens gracias a CodeGraph + Chesterton's Fence + Verify Before Refactor.


🔁 Handoff de sesión (Project Manager Multi-IDE)

El agente project-manager está diseñado para que puedas pausar y retomar el trabajo entre múltiples IDEs y herramientas de IA (tales como opencode, Claude Code, Cursor, Copilot, Open WebUI, etc.) sin perder el estado ni "recargar" el contexto de forma manual.

Al finalizar una petición o detenerse, el agente deja un bloque SESSION HANDOFF estructurado que cualquier intérprete de IA puede leer directamente para reanudar el trabajo:

  • Git Context: Rama activa, commits recientes y archivos modificados.
  • Working Set: Lista mínima de archivos de trabajo activos y rangos de líneas bajo modificación.
  • CodeGraph Status: Estado de sincronización del índice.
  • Token Stats: Ahorro acumulado a partir de token_usage_comparison.json.
  • Próximos pasos ordenados: Acciones concretas que debe realizar el siguiente agente.

📊 Dónde se guardan los datos de tokens

El instalador puede generar una comparativa estimada en:

  • $env:SKILLGRID_SCRATCH\token_usage_comparison.json (si configuraste la variable)
  • o un scratch/token_usage_comparison.json cerca del root donde corre el instalador

Ese JSON incluye, por proyecto: baseline_full_scan_tokens, codegraph_context_tokens, estimated_savings_tokens y savings_percentage.

🤝 Crear tu propia skill

Copia el template y completa los campos:

skills/tu-skill/
  ├── SKILL.md          ← Instrucciones para el agente (frontmatter YAML obligatorio)
  └── references/       ← (Opcional) Docs profundas para progressive disclosure

El frontmatter mínimo requerido:

---
name: tu-skill
description: "Usar cuando [condición específica]."
category: core | design | agent
status: stable | beta | experimental | deprecated | draft
risk_level: safe | critical
---

Contribuciones via Pull Request son bienvenidas. El CI valida automáticamente el frontmatter. 🟢

🛠️ Optimización del Repositorio para Desarrollo con IA (Dev-Mode)

Si estás desarrollando o contribuyendo al propio repositorio de SkillGrid con asistentes de IA (tales como opencode, antigravity, Claude Code, Cursor o Copilot), puedes inicializar las reglas locales, el índice de CodeGraph y la memoria persistente ejecutando el instalador apuntando al directorio raíz del proyecto:

En Windows (PowerShell):

.\install.ps1 -ProjectDir . -Language typescript -GenerateCodex

En Linux / macOS (Bash):

./install.sh --project . --language typescript

Esto configurará:

  1. Reglas de IDE locales: En .cursor/rules/ y .github/instructions/ específicas para TypeScript/JS/Scripts.
  2. Índice CodeGraph: En .codegraph/ para navegación semántica ultrarrápida.
  3. Memoria Persistente (CODEX.md): Para recordar el contexto del repositorio y evitar alucinaciones.
  4. Git Exclude: Configura automáticamente .git/info/exclude para que estas configuraciones locales permanezcan privadas y no contaminen el árbol de commits.

v1.2 "Audit Depth & Asset Pipeline" (2026-06-07)

Marketing Audit Expansion (from marketingskills)

  • Schema markup deep audit: Added section 5 with JSON-LD type validation, Google Rich Results eligibility checks, BreadcrumbList/Sitelinks integrity, and structured data conflict detection
  • AEO/GEO/LLMO audit: Added section 6 covering LLM citation readiness, SpeakableSpecification/FAQPage schema for AI surfaces, featured snippet compatibility, and entity recognition via Wikidata/Wikipedia
  • Programmatic SEO audit: Added section 7 with template scalability checks, content depth threshold (300-word minimum), index bloat detection, and contextual internal linking verification
  • Copy quality & messaging audit: Added section 8 with value proposition clarity, conversion copy patterns (PAS/BAB/FAB), emotional triggers, trust signals placement, and multi-segment detection
  • Report schema extended: Added schema_score, aeo_geo_readiness_score, programmatic_seo_score, and copy_quality_score to summary output

Visual Asset Pipeline (from web-asset-generator)

  • Web asset generation pipeline: Added full favicon multi-resolution generation (16×16 → 512×512), social media OG image templates (FB/LinkedIn/Twitter/YouTube/Pinterest), and PWA manifest.json auto-generation
  • Asset validation system: Added dimension/format checks, WCAG 4.5:1 contrast ratio validation for text overlays, and file size budget table per asset type
  • Emoji library: Added 7 curated emoji categories (60+ emojis) with brand-context suggestions and geometric icon fallback via ImageMagick
  • Framework auto-integration: CodeGraph-based detection of Next.js/Astro/Vite/Nuxt/Angular with automatic <link> and <meta> tag insertion in the correct layout file
  • Severity matrix & verification gate: Updated to cover favicon 404, OG image size limits, PWA path mismatches, and WCAG contrast gaps

v1.1 "Lean & Efficient" (2026-06-07)

Token Economy Improvements

  • Deduplicated platform modules: ~480 lines of repeated ## Modules footer extracted to skills/shared/modules-footer.md — single reference line per skill
  • Frontmatter index: New skills/index.json with progressive disclosure metadata (token estimates, cost tiers, invocation graph) for all 30 skills
  • Token budget metadata: Added token_estimate: { input, output } to every SKILL.md frontmatter (estimated from actual file sizes)
  • Install profiles: Added minimal/standard/strict profiles to skills/bundles/index.json for progressive skill loading
  • Session runtime controls: New skills/shared/session-controls.md with environment variables (SKILLGRID_HOOK_PROFILE, SKILLGRID_DISABLED_SKILLS, etc.)

Shared Resources

  • Stack detection: Extracted from audit-loop to skills/shared/stack-detection.md — shared by audit-loop and auditor-de-seguridad

Security Hardening

  • Security framework mappings: New skills/auditor-de-seguridad/references/mitre-attack.md mapping all 12 scanner categories to MITRE ATT&CK v19.1 and NIST CSF 2.0
  • External repo integration guide: New skills/auditor-de-seguridad/references/external-repos.md for progressive disclosure of third-party security skills
  • Findings schema enhanced: Added optional cwe_id and mitre_technique_id fields to audit findings
  • CVSS 4.0 rubric & Risk Decision Matrix: Added to skills/shared/risk-assessment.md along with Risk Treatment Decision Tree
  • Security anti-rationalizations: 4 new rows in skills/shared/anti-rationalization.md covering scanner false confidence, POC security debt, auth retrofit, and internal-only encryption

Enhancements

  • db-schema-detector: Re-categorized from agent to core (18→19 core, 9→8 agent)
  • Incremental CodeGraph sync: Added to skills/shared/codegraph-startup.md — timestamp-based diffing to avoid full rescans
  • DESIGN_VARIANCE dial: Updated description in impeccable-design-taste (section renamed to "The Four Dials")
  • Academic research pipeline: New skills/gestor-documental/references/research-pipeline.md with 10-stage workflow

🔄 Ralph Loop Runner (Bucle Autónomo)

SkillGrid incluye scripts automatizados para implementar el Ralph Loop de ejecución autónoma en tu terminal. Esto ejecuta al agente de IA (como claude o antigravity-ide) en ciclos iterativos independientes, permitiendo que avance tarea por tarea sin saturar la ventana de contexto de una sola conversación larga.

El runner lee un archivo de seguimiento (por defecto task.md) y se detiene automáticamente cuando no quedan tareas pendientes, o cuando alcanza el límite de iteraciones configurado.

Uso en Windows (PowerShell)

# Ejecución básica (usa 'claude' y 'task.md')
.\scripts\ralph-loop.ps1

# Personalizado
.\scripts\ralph-loop.ps1 -AgentCommand "antigravity-ide" -TaskFile "task.md" -MaxIterations 5 -DelaySeconds 10

Uso en Linux / macOS (Bash)

# Ejecución básica
bash scripts/ralph-loop.sh

# Personalizado (Parámetros posicionales: agente, taskfile, max_iter, delay)
bash scripts/ralph-loop.sh "claude" "task.md" 5 10

Licencia

MIT — Fabian Melo Maciel

Ver o original no GitHub

Bom para

Relacionados