SkillGrid
fabianmelomaciel/SkillGrid
31 skills para potencializar seu copiloto de IA em desenvolvimento
Ver no GitHubColeçã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/SkillGrid1 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
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
⚡ ¡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
minimalpara 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
| Perfil | Enfoque | Cuándo usar |
|---|---|---|
minimal | Gates mínimos | Principiantes, sesiones cortas, cambios pequeños |
standard | Flujo completo | Desarrollo normal día a día |
testing | QA & E2E | Equipos de QA — solo 4 skills, ~8K tokens |
strict | Suite completa | Auditorías y hardening (más pesado) |
all | Todo | Só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
minimalostandard. - Si te piden auditoría completa (seguridad/marketing/finops) o coordinación total, usá
strictoall.
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/ybundles/(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
| Herramienta | Soporte | Ruta 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 | ⚙️ Manual | aider --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:
| Skill | Cuándo la usas |
|---|---|
brainstorming | Antes de tocar código — diseña la feature primero |
changelog-generator | Genera notas de lanzamiento automatizadas analizando el historial de Git |
spec-driven-development | Cuando los requerimientos son vagos o ambiguos |
writing-plans | Para planificar cambios que tocan múltiples archivos |
incremental-implementation | Para entregar en rebanadas seguras y revisables |
playwright-testing | Diseñar, escribir y optimizar pruebas E2E y de componente con Playwright |
test-driven-development | Red → Green → Refactor con disciplina real |
systematic-debugging | Cuando algo falla y no sabés por qué |
code-simplification | Refactorizar sin cambiar comportamiento |
verification-before-completion | Antes de decir "está listo" — evidencia concreta |
context-engineering | Cuando el agente empieza a alucinar por context flooding |
db-schema-detector | Detecta bases de datos locales y genera esquemas cached en CodeGraph para ahorrar tokens |
dispatching-parallel-agents | 2+ tareas independientes — lanzalas en paralelo |
subagent-driven-development | Ejecutar planes grandes con subagentes especializados |
requesting-code-review | Antes de mergear — checklist + evidencia |
receiving-code-review | Cuando recibís feedback — no aplicar a ciegas |
finishing-a-development-branch | Cerrar ramas: merge, PR, o cleanup |
using-git-worktrees | Aislar features para no romper el workspace |
writing-skills | Crear y testear tus propias skills |
executing-plans | Ejecutar planes por lotes con checkpoints de revisión |
🎨 Design Engineering — Calidad visual premium
| Skill | Qué hace |
|---|---|
impeccable-design-taste | Auditorí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-design | Animaciones ≤300ms, micro-interacciones, perceived performance. Principios de diseño de Emil Kowalski aplicados sistemáticamente. |
creativo-visual | Director 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:
| Agente | Rol |
|---|---|
auditor-de-seguridad | Escanea 12 categorías: secrets, dependencias, SAST (OWASP Top 10), rate limiting, auth, API security, encryption, logging, compliance, infra, DB y CI/CD |
audit-loop | Follow-up de auditorías. Clasifica hallazgos, aplica fixes seguros automáticamente, pide OK para los sensibles, re-audita hasta 3 veces |
agente-devops | Diseña y audita Dockerfiles y pipelines CI/CD seguros. Alineado con IEEE 730 e ISO 27001 |
agente-ideas | Deliberació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-marketing | Audita SEO on-page, schema markup, AEO/GEO, programmatic SEO, AI writing (30 patrones), copy quality, OpenGraph, readability y CRO |
optimizador-finops | Analiza consumo de tokens, comprime prompts, detecta llamadas redundantes a APIs |
project-manager | Escucha al CEO, planifica, delega a agentes especializados, revisa resultados y reporta |
gestor-documental | Formatea documentación técnica y académica (APA 7ª ed., ISO 29148, ISO 29119) |
🎁 Bundles por rol
Instala solo lo que necesita tu equipo:
| Bundle | Qué incluye |
|---|---|
core | Las 20 skills de metodología de desarrollo |
devops | agente-devops · audit-loop · auditor-de-seguridad · optimizador-finops |
design | impeccable-design-taste · emil-kowalski-design · creativo-visual |
testing | playwright-testing · test-driven-development · systematic-debugging · verification-before-completion |
management | project-manager · gestor-documental · audit-loop · agente-ideas |
marketing | auditor-de-marketing |
⚡ Workflows multi-skill
Combinaciones pre-diseñadas para tareas complejas:
| Workflow | Secuencia |
|---|---|
| Feature completa | brainstorming → spec-driven-development → writing-plans → incremental-implementation → requesting-code-review → finishing-a-development-branch |
| Feature con E2E | brainstorming → spec-driven-development → writing-plans → test-driven-development → incremental-implementation → playwright-testing → requesting-code-review → finishing-a-development-branch |
| Auditoría + reparación | auditor-de-seguridad → audit-loop |
| Deploy seguro | agente-devops → auditor-de-seguridad → audit-loop |
| Rediseño UI | brainstorming → impeccable-design-taste → emil-kowalski-design → incremental-implementation |
| Auditoría completa | auditor-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
corey nuevo bundle/perfiltesting(4 skills, ~8K tokens). - models.json: 3 modelos nuevos —
gemini-2.5-flash,claude-sonnet-4.6-thinking,o4-minicon 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.jsonal corrernpm run catalog. Previene desincronización futura entre catalog.json e index.json. - README: Workflow "Feature con E2E" agregado. Perfil
testingdocumentado 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.ps1andremote-install.shpinned to--branch v1.0.0to prevent supply-chain attacks - rm -rf guard: Added confirmation prompt in
install.shbefore any destructive operation - Dependency lock:
package-lock.jsongenerated to freeze dependency tree - CI/CD tracking restored:
.github/workflows/removed from.gitignore— pipelines now tracked in version control
Bugfixes
workflows.md: Fixed typoimperfectable→impeccablegestor-documental/SKILL.md: Sections 3 and 4 swapped to correct logical orderauditor-de-seguridad/SKILL.md: Added missingverification-gate.mdto shared protocol referencessession-controls.md: Now documentsSKILLGRID_SCRATCHenv var
Maintainability
- DRY reporting:
scripts/report-common.ps1created — sharedEscape-Htmlfunction used byaudit.ps1andgenerate-report-from-json.ps1 - Inline JS externalized:
scripts/install-tasks.jsextracted frominstall.ps1(~739→~557 lines) - Parallel scanners: All 12 security scanners in
audit.ps1now run viaStart-Jobfor PowerShell 5.1 - Install profiles:
minimal/standard/strictprofiles via-Profileflag - Header normalization:
stack-detection.mdheader#→##
Content Improvements
- AI writing patterns: 30 detection patterns extracted from
auditor-de-marketing/SKILL.mdtoreferences/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, andauditor-de-seguridad - Session controls referenced:
session-controls.mdlinked fromcontext-engineeringandproject-managerfooters
🚀 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ón | Para qué sirve |
|---|---|
🎯 Project Context | Stack, DB, directorios, deployment — el agente no te vuelve a preguntar |
💡 Token Economy Rules | Reglas de eficiencia: sin preámbulos, output compacto, verificación inmediata |
🏗️ Active Design System | Paleta, tipografía, radios — consistencia visual garantizada |
🛠️ Technical Gotchas | Quirks del entorno, reglas del proyecto descubiertas en el camino |
💻 Mission Logs | Historial de decisiones y soluciones — el agente aprende de cada sesión |
El instalador nunca sobreescribe tu
CODEX.mdsi 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étrica | Full Scan (sin CodeGraph) | Con CodeGraph | Reducción |
|---|---|---|---|
| Tokens de contexto | 368,298 | 38,830 | −89.5% |
| Plataforma / Herramienta | Modelo | Costo Full Scan | Costo con CodeGraph | Ahorro CodeGraph |
|---|---|---|---|---|
| opencode | Claude Sonnet 4.6 | $0.921 | $0.097 | 89.5% |
| opencode | DeepSeek V4 Flash | $0.184 | $0.019 | 89.5% |
| Antigravity | Gemini 1.5 Flash | $0.028 | $0.003 | 89.5% |
| Antigravity / Cursor | Gemini 1.5 Pro | $0.460 | $0.049 | 89.5% |
| Antigravity IDE | Gemini 2.5 Pro | $0.460 | $0.049 | 89.5% |
| Claude Code | Claude 3.5 Sonnet | $1.105 | $0.116 | 89.5% |
| Cursor IDE | GPT-4o / Claude 3.5 | $0.921 | $0.097 | 89.5% |
| GitHub Copilot | GPT-4o | $0.921 | $0.097 | 89.5% |
| Open WebUI | Multi-model | variable | variable | ≥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 / Regla | Ahorro adicional estimado | Cómo evita desperdicio de tokens |
|---|---|---|
| Chesterton's Fence (auditor no propone refactor innecesario) | −50% a −80% en hallazgos falsos | Cada 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ón | El audit-loop ya no itera sobre cambios que no deberían hacerse |
| DRY Enforcement (no duplicar código) | −10% a −20% en código generado | Se reusa código existente en vez de crear desde cero |
| Dual-Environment Protocol (localhost vs producción) | −15% a −30% en sugerencias inválidas | No 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 cargada | Skills 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ón | No 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.jsoncerca 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á:
- Reglas de IDE locales: En
.cursor/rules/y.github/instructions/específicas para TypeScript/JS/Scripts. - Índice CodeGraph: En
.codegraph/para navegación semántica ultrarrápida. - Memoria Persistente (
CODEX.md): Para recordar el contexto del repositorio y evitar alucinaciones. - Git Exclude: Configura automáticamente
.git/info/excludepara 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/FAQPageschema 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, andcopy_quality_scoreto 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
## Modulesfooter extracted toskills/shared/modules-footer.md— single reference line per skill - Frontmatter index: New
skills/index.jsonwith 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/strictprofiles toskills/bundles/index.jsonfor progressive skill loading - Session runtime controls: New
skills/shared/session-controls.mdwith 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.mdmapping 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.mdfor progressive disclosure of third-party security skills - Findings schema enhanced: Added optional
cwe_idandmitre_technique_idfields to audit findings - CVSS 4.0 rubric & Risk Decision Matrix: Added to
skills/shared/risk-assessment.mdalong with Risk Treatment Decision Tree - Security anti-rationalizations: 4 new rows in
skills/shared/anti-rationalization.mdcovering scanner false confidence, POC security debt, auth retrofit, and internal-only encryption
Enhancements
- db-schema-detector: Re-categorized from
agenttocore(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.mdwith 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