Content
# 🧠 Oracle DB Skills — Guías de IA para Oracle Database
[](https://www.oracle.com/database/)
[](https://github.com/krisrice/oracle-db-skills)
[](skills/)
[](README.md)
[](https://github.com/krisrice/oracle-db-skills)
> **Tu equipo de base de datos lleva años resolviendo los mismos problemas.**
> **¿Y si un agente de IA ya supiera exactamente cómo hacerlo?**
Oracle publicó más de **100 guías de IA listas para usar** con cualquier agente (Claude, Copilot, Cursor…) conectado a una base de datos Oracle. Este repositorio es la **versión en español** con guía de uso práctica para equipos en LATAM.
Sin inventar queries. Sin consumir tokens buscando en Google. **El agente ya sabe.**
---
## ⚡ Instalación en un comando
```bash
npx skills install krisrice/oracle-db-skills
```
Eso es todo. En segundos tu agente de IA tiene acceso a todas las guías.
---
## 🎯 ¿Qué resuelve esto?
Ejemplo real: le preguntas al agente cuáles son las **peores queries de las últimas 24 horas**.
En segundos conecta a tu base de datos Oracle, ejecuta el análisis de AWR/ASH y te entrega un reporte completo — sin que tú escribas una sola línea de SQL.
| Sin Oracle DB Skills | Con Oracle DB Skills |
|---------------------|---------------------|
| El agente inventa SQL incorrecto | El agente usa sintaxis Oracle validada |
| Respuestas genéricas sin contexto Oracle | Respuestas específicas con V$ views, hints, DBMS_* |
| Consume tokens buscando la sintaxis correcta | Va directo al punto con ejemplos reales |
| No sabe las diferencias 19c vs 26ai | Explica compatibilidad por versión |
---
## ✅ Categorías cubiertas
| Categoría | Skills | Casos de uso típicos |
|-----------|--------|---------------------|
| 🚀 Performance & Tuning | 7 | AWR, ASH, explain plan, índices, wait events |
| 🔐 Seguridad & Auditoría | 6 | TDE, VPD, Unified Auditing, enmascaramiento |
| 🔄 Migraciones | 14 | Desde PostgreSQL, MySQL, SQL Server, MongoDB |
| 📦 PL/SQL | 12 | Packages, cursores, colecciones, unit testing |
| 📊 Monitoreo | 5 | Alert log, top SQL, health checks, espacio |
| 🌐 ORDS / REST | 10 | APIs REST, OAuth2, AutoREST, PL/SQL gateway |
| ⚙️ DevOps & CI/CD | 5 | Liquibase, Flyway, EBR, utPLSQL, git para SQL |
| 💻 SQL Development | 5 | Window functions, CTEs, MERGE, PIVOT, injection |
| 🏗️ Administración | 6 | RMAN, Data Guard, undo, redo, usuarios |
| 🏛️ Arquitectura | 5 | RAC, CDB/PDB, Exadata, In-Memory, OCI |
| 🔧 Desarrollo de Apps | 14 | Python, Java, Node.js, .NET, Go + connection pooling |
| 📐 Diseño de BD | 4 | ERD, modelado, particionamiento, tablespaces |
| 🛠️ SQLcl | 8 | Scripting, Liquibase CLI, **MCP Server** |
| 🖼️ Frameworks | 9 | SQLAlchemy, Django, Spring, MyBatis, GORM |
---
## 🚀 Guía de uso rápido
### Paso 1 — Instalar las skills
```bash
# Requiere Node.js 18+
npx skills install krisrice/oracle-db-skills
```
### Paso 2 — Conectar tu agente de IA a Oracle
Si usas **Claude Desktop**, primero configura el MCP Server de Oracle:
```json
{
"mcpServers": {
"oracle-db": {
"command": "C:\\tools\\sqlcl\\bin\\sql.exe",
"args": ["-mcp"],
"env": {
"TNS_ADMIN": "C:\\oracle\\network\\admin"
}
}
}
}
```
> 📖 Guía completa de configuración MCP: [oracle-ai-mcp-server](https://github.com/jesmonsa/oracle-ai-mcp-server)
### Paso 3 — Usar el agente con lenguaje natural
Con las skills instaladas y el agente conectado a Oracle, ya puedes preguntar directamente:
---
## 💬 Ejemplos de uso real
### Performance
```
¿Cuáles son las 10 queries con mayor consumo de CPU en las últimas 24 horas?
```
```
Analiza el plan de ejecución de esta query y dime por qué está haciendo full table scan
```
### Seguridad
```
¿Qué usuarios tienen acceso a la tabla de clientes y qué pueden hacer?
```
```
Genera un reporte de auditoría de accesos fallidos de esta semana
```
### Migraciones
```
Tengo esta query en PostgreSQL, conviértela a Oracle y dime qué diferencias hay
```
```
¿Cuál es la equivalencia de SERIAL de PostgreSQL en Oracle 19c?
```
### PL/SQL
```
Revisa este package y dime qué problemas de rendimiento tiene
```
```
Crea un procedure que haga bulk collect de facturas vencidas y las archive
```
### Monitoreo
```
¿Hay algún problema de espacio en los tablespaces? Dame un resumen
```
```
¿Cuáles son los wait events más frecuentes de hoy?
```
### DevOps
```
Genera un script de Liquibase para este cambio de schema
```
```
¿Cómo implemento zero-downtime deployment para esta tabla?
```
---
## 📁 Estructura del repositorio
```
oracle-db-skills-es/
│
├── README.md ← Este archivo (en español)
├── COMO-USAR.md ← Guía detallada de uso con ejemplos LATAM
├── SKILL.md ← Metadata para el CLI de skills
│
└── skills/ ← Las 100+ guías (referencia al repo original)
├── performance/ → AWR, ASH, índices, explain plan
├── security/ → TDE, VPD, auditoría, cifrado
├── plsql/ → Packages, cursores, colecciones
├── migrations/ → Migraciones desde otros motores
├── monitoring/ → Alert log, top SQL, espacio
├── ords/ → REST APIs, OAuth2
├── devops/ → Liquibase, Flyway, CI/CD
├── sql-dev/ → SQL patterns, inyección
├── admin/ → RMAN, Data Guard, usuarios
├── architecture/ → RAC, CDB/PDB, OCI
├── appdev/ → Python, Java, Node.js, pooling
├── design/ → ERD, modelado, particionamiento
├── sqlcl/ → SQLcl, MCP Server
└── frameworks/ → SQLAlchemy, Django, Spring
```
---
## 🔗 Recursos relacionados
| Recurso | Descripción |
|---------|-------------|
| [oracle-db-skills (original)](https://github.com/krisrice/oracle-db-skills) | Repositorio oficial en inglés de Oracle |
| [oracle-ai-mcp-server](https://github.com/jesmonsa/oracle-ai-mcp-server) | Kit completo para conectar Oracle con Claude Desktop |
| [Documentación Oracle SQLcl](https://docs.oracle.com/en/database/oracle/sql-developer-command-line/) | Documentación oficial de SQLcl |
| [Model Context Protocol](https://modelcontextprotocol.io/) | Estándar MCP |
---
## 👤 Autor
**Jesús Andrés Montoya**
Cloud Architect & Oracle Database Specialist — Oracle Cloud Infrastructure, Colombia & LATAM
[](https://github.com/jesmonsa)
---
## 📄 Créditos y Licencia
El contenido de las guías es obra de [krisrice](https://github.com/krisrice) y el equipo de Oracle.
Esta adaptación en español es un trabajo derivado bajo los mismos términos de la licencia original.
Ver: [LICENSE](LICENSE)
