Add AI Database skills for Select AI and AI Vector Search

AGENTS.md

@@ -1,10 +1,10 @@
 # Oracle DB Skills — Agent Instructions
 
-This repository is a collection of 128 standalone reference guides for Oracle Database and Oracle Container Registry database-category images. Each file covers one topic with explanations, practical examples, best practices, and common mistakes.
+This repository is a collection of 149 standalone reference guides for Oracle Database and Oracle Container Registry database-category images. Each file covers one topic with explanations, practical examples, best practices, and common mistakes.
 
 ## How to Use This Collection
 
-1. **Find the right skill** — scan `SKILLS.md` at the repo root for a flat index of all skills with descriptions, or use the category routing below.
+1. **Find the right skill** — scan `SKILLS.md` at the repo root for a flat index of all skills with descriptions, or use the category routing below. For AI and containers, prefer the category-specific sub-index when the question is still broad.
 2. **Load on demand** — read only the specific skill file(s) relevant to the user's task. Do not attempt to load all files at once.
 3. **Apply the guidance** — use the content to answer questions, generate code, or review existing work.
 
@@ -13,6 +13,7 @@ This repository is a collection of 128 standalone reference guides for Oracle Da
 ```
 skills/
 ├── admin/          Database administration (backup, recovery, users, redo/undo)
+├── ai/             AI Database topics (Select AI, AI Agent, AI Vector Search, RAG guidance)
 ├── appdev/         Application development (JSON, XML, spatial, text, pooling)
 ├── architecture/   Infrastructure (RAC, Multitenant, Exadata, In-Memory, OCI)
 ├── containers/     OCR Database-category container repositories
@@ -34,6 +35,7 @@ skills/
 | User asks about… | Load from |
 |------------------|-----------|
 | Backup, recovery, RMAN, redo/undo logs, users | `skills/admin/` |
+| Select AI, Select AI for Python, AI Agent, AI Vector Search, vector indexes, semantic search, RAG on Oracle AI Database | `skills/ai/SKILLS.md` |
 | JDBC, connection pooling, JSON, XML, spatial, full-text, transactions, property graphs | `skills/appdev/` |
 | RAC, CDB/PDB, Exadata, In-Memory, OCI, ATP/ADW, Data Guard | `skills/architecture/` |
 | ERD, data modeling, partitioning, tablespaces | `skills/design/` |
@@ -47,17 +49,23 @@ skills/
 | Privileges, VPD, TDE, encryption, auditing, network security | `skills/security/` |
 | SQL patterns, window functions, CTEs, dynamic SQL, injection | `skills/sql-dev/` |
 | SQLcl commands, scripting, Liquibase CLI, MCP server, CI/CD | `skills/sqlcl/` |
-| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/` |
+| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/SKILLS.md` |
 
 ## Key Skills to Know
 
+- **`skills/ai/SKILLS.md`** — task router for the AI category
+- **`skills/ai/ai-vector-search.md`** — entry point for Oracle AI Vector Search concepts and routing
+- **`skills/ai/select-ai.md`** — entry point for Select AI concepts and routing
+- **`skills/ai/select-ai-python.md`** — routing between `select_ai`, SQL, and PL/SQL Select AI use from Python
 - **`skills/sqlcl/sqlcl-mcp-server.md`** — how to connect AI assistants (including Claude) to Oracle via the SQLcl MCP server
 - **`skills/migrations/migration-assessment.md`** — start here for any database migration project
 - **`skills/performance/explain-plan.md`** — foundation for all SQL performance work
 - **`skills/plsql/plsql-package-design.md`** — foundation for PL/SQL architecture questions
 - **`skills/devops/schema-migrations.md`** — Liquibase/Flyway with Oracle in CI/CD pipelines
 - **`skills/containers/container-selection-matrix.md`** — quick decision matrix for choosing the right OCR database-category image
 
+For the complete AI index and task router: `skills/ai/SKILLS.md`
+
 ## Common Container Skills (Primary)
 
 - **`skills/containers/adb-free.md`** — Autonomous Database Free container image with ADW/ATP guidance

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## What This Repository Is
 
-A library of 128 standalone Oracle Database and OCR container reference guides (skill files) organized by category under `skills/`. Each file covers one topic with explanations, examples, and version-specific notes. There is no build system, test suite, or compilation step — this is a pure Markdown content library.
+A library of 149 standalone Oracle Database and OCR container reference guides (skill files) organized by category under `skills/`. Each file covers one topic with explanations, examples, and version-specific notes. There is no build system, test suite, or compilation step — this is a pure Markdown content library.
 
 ## Adding or Modifying Skill Files
 
@@ -35,14 +35,17 @@ These files must stay in sync when skills are added or renamed:
 | [AGENTS.md](AGENTS.md) | Category routing table for AI agents |
 | [SKILL.md](SKILL.md) | Root metadata for skills.sh CLI discovery |
 | [skills-index.md](skills-index.md) | Completion tracking checklist |
+| [skills/ai/SKILLS.md](skills/ai/SKILLS.md) | AI sub-index and task router (not counted as a standalone skill) |
+| [skills/containers/SKILLS.md](skills/containers/SKILLS.md) | Container sub-index and task router (not counted as a standalone skill) |
 
-When adding a new skill file, update all four of these files.
+When adding a new skill file, update the root discovery files above. If the skill is in a category with a local sub-index, update that sub-index too.
 
 ## Category Routing
 
 | Topic | Directory |
 |-------|-----------|
 | Backup, recovery, RMAN, redo/undo, users | `skills/admin/` |
+| Select AI, Select AI for Python, AI Agent, AI Vector Search, vector indexes, semantic search, RAG on Oracle AI Database | `skills/ai/SKILLS.md` |
 | JDBC, connection pooling, JSON, XML, spatial, full-text, transactions, property graphs | `skills/appdev/` |
 | RAC, CDB/PDB, Exadata, In-Memory, OCI, ATP/ADW, Data Guard | `skills/architecture/` |
 | ERD, data modeling, partitioning, tablespaces | `skills/design/` |
@@ -56,10 +59,14 @@ When adding a new skill file, update all four of these files.
 | Privileges, VPD, TDE, encryption, auditing, network security | `skills/security/` |
 | SQL patterns, window functions, CTEs, dynamic SQL, injection | `skills/sql-dev/` |
 | SQLcl commands, scripting, Liquibase CLI, MCP server, CI/CD | `skills/sqlcl/` |
-| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/` |
+| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/SKILLS.md` |
 
 ## Key Starting Points
 
+- [skills/ai/SKILLS.md](skills/ai/SKILLS.md) — task router for the AI category
+- [skills/ai/ai-vector-search.md](skills/ai/ai-vector-search.md) — entry point for Oracle AI Vector Search concepts and routing
+- [skills/ai/select-ai.md](skills/ai/select-ai.md) — entry point for Select AI concepts and routing
+- [skills/ai/select-ai-python.md](skills/ai/select-ai-python.md) — routing between `select_ai`, SQL, and PL/SQL Select AI use from Python
 - [skills/sqlcl/sqlcl-mcp-server.md](skills/sqlcl/sqlcl-mcp-server.md) — connecting AI assistants to Oracle via the SQLcl MCP server
 - [skills/migrations/migration-assessment.md](skills/migrations/migration-assessment.md) — start here for any migration project
 - [skills/performance/explain-plan.md](skills/performance/explain-plan.md) — foundation for SQL performance work

README.md

@@ -1,6 +1,6 @@
 # Oracle DB Skills
 
-Oracle DB Skills is a curated library of 128 practical, documentation-backed guides for working with Oracle Database and Oracle Container Registry database-category images, organized by domain: SQL and PL/SQL development, performance tuning, security, administration, monitoring, architecture, DevOps, migrations, SQLcl, ORDS, Oracle-specific features, and container-image repositories. The guides include actionable examples, best practices, common pitfalls, sources, and Oracle version compatibility notes where relevant.
+Oracle DB Skills is a curated library of 149 practical, documentation-backed guides for working with Oracle Database and Oracle Container Registry database-category images, organized by domain: SQL and PL/SQL development, AI Database topics, performance tuning, security, administration, monitoring, architecture, DevOps, migrations, SQLcl, ORDS, Oracle-specific features, and container-image repositories. The guides include actionable examples, best practices, common pitfalls, sources, and Oracle version compatibility notes where relevant.
 
 ## Version Coverage Standard
 
@@ -25,6 +25,7 @@ Oracle DB Skills is a curated library of 128 practical, documentation-backed gui
 | [SQL Development](#sql-development) | 6 | `skills/sql-dev/` |
 | [Performance & Tuning](#performance--tuning) | 7 | `skills/performance/` |
 | [Application Development](#application-development) | 14 | `skills/appdev/` |
+| [AI Database](#ai-database) | 21 | `skills/ai/` |
 | [Security](#security) | 6 | `skills/security/` |
 | [Administration](#administration) | 5 | `skills/admin/` |
 | [Monitoring & Diagnostics](#monitoring--diagnostics) | 5 | `skills/monitoring/` |
@@ -106,6 +107,56 @@ Oracle DB Skills is a curated library of 128 practical, documentation-backed gui
 
 ---
 
+## AI Database
+
+`skills/ai/`
+
+Complete AI task index: `skills/ai/SKILLS.md`
+(`skills/ai/SKILLS.md` is an index helper and is not counted as a standalone skill guide.)
+
+### Start Here
+
+| File | Description |
+|------|-------------|
+| `select-ai.md` | Select AI overview, capability boundaries, and routing guide |
+| `ai-vector-search.md` | Oracle AI Vector Search overview, capability boundaries, and routing guide |
+
+### Select AI
+
+| File | Description |
+|------|-------------|
+| `select-ai-accuracy.md` | cross-cutting Select AI accuracy workflow: scope, metadata, inspection, case sensitivity, and feedback |
+| `select-ai-annotations.md` | annotation DDL, profile integration, annotation views, and Select AI metadata usage |
+| `select-ai-profiles.md` | AI profile lifecycle, attributes, provider configuration, session activation |
+| `select-ai-security.md` | privilege model, metadata/data exposure controls, private endpoints, and AI proxy security |
+| `select-ai-prompts.md` | prompt wording rules, `showprompt`, prompt augmentation, and action guidance |
+| `select-ai-actions.md` | `SELECT AI` / `DBMS_CLOUD_AI.GENERATE` actions, `showprompt`, `chat`, `translate`, `summarize` |
+| `select-ai-python.md` | routing between `select_ai`, `SELECT AI`, and package-based Select AI use from Python |
+| `select-ai-metadata.md` | `object_list`, metadata controls, comments, annotations, constraints, data access |
+| `select-ai-feedback.md` | `feedback` action, `DBMS_CLOUD_AI.FEEDBACK`, feedback vector index, SQL refinement workflow |
+| `select-ai-rag.md` | Select AI RAG flow, vector-index integration, `embedding_model`, `enable_sources` |
+
+### AI Vector Search
+
+| File | Description |
+|------|-------------|
+| `vector-data-type.md` | `VECTOR` type definitions, dense/sparse formats, restrictions, vector descriptors |
+| `vector-embeddings.md` | ONNX models, third-party embeddings, chunking, `DBMS_VECTOR_CHAIN` pipelines |
+| `vector-packages.md` | `DBMS_VECTOR`, `DBMS_VECTOR_CHAIN`, `DBMS_HYBRID_VECTOR`, reranking, generated text, package selection |
+| `vector-operations.md` | distance metrics, operators, exact/approximate search, vector SQL functions |
+| `vector-indexes.md` | IVF/HNSW, `CREATE VECTOR INDEX`, advisor procedures, restrictions |
+| `hybrid-vector-search.md` | `CREATE HYBRID VECTOR INDEX`, `DBMS_HYBRID_VECTOR`, hybrid query patterns |
+
+### Advanced / Diagnostics
+
+| File | Description |
+|------|-------------|
+| `select-ai-agent.md` | `DBMS_CLOUD_AI_AGENT`, teams, agents, tasks, tools, built-in tool support |
+| `select-ai-synthetic-data.md` | `GENERATE_SYNTHETIC_DATA`, params, monitoring status tables, metadata-clone workflows |
+| `vector-diagnostics.md` | vector views, memory pool, initialization parameters, diagnostic routing |
+
+---
+
 ## Security
 
 `skills/security/`
@@ -305,6 +356,7 @@ oracle-db-skills/
 ├── skills-index.md          # Full checklist of all files with completion status
 └── skills/
     ├── admin/               # Administration
+    ├── ai/                  # AI Database
     ├── appdev/              # Application Development
     ├── architecture/        # Architecture & Infrastructure
     ├── containers/          # OCR Database-category container repositories

SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: oracle-db-skills
-description: 128 Oracle Database and OCR container reference guides covering SQL, PL/SQL, performance tuning, security, ORDS, SQLcl, container images, migrations, and more. Load individual skill files on demand for expert guidance on any Oracle topic.
+description: 149 Oracle Database and OCR container reference guides covering SQL, PL/SQL, AI Database topics, performance tuning, security, ORDS, SQLcl, container images, migrations, and more. Load individual skill files on demand for expert guidance on any Oracle topic.
 ---
 
 # Oracle DB Skills
 
-A collection of 128 standalone reference guides for Oracle Database and OCR database-category container images. Each file covers one topic with explanations, practical examples, best practices, and common mistakes.
+A collection of 149 standalone reference guides for Oracle Database and OCR database-category container images. Each file covers one topic with explanations, practical examples, best practices, and common mistakes.
 
 ## How to Use
 
-1. **Find the right skill** using the category routing table below.
+1. **Find the right skill** using the category routing table below. For AI and containers, prefer the category-specific sub-index when the question is still broad.
 2. **Read only the file(s)** relevant to the user's task — do not load all files at once.
 3. **Apply the guidance** to answer questions, generate code, or review existing work.
 
@@ -18,6 +18,7 @@ A collection of 128 standalone reference guides for Oracle Database and OCR data
 | User asks about… | Read from |
 |------------------|-----------|
 | Backup, recovery, RMAN, redo/undo logs, users | `skills/admin/` |
+| Select AI, Select AI for Python, AI Agent, AI Vector Search, vector indexes, semantic search, RAG on Oracle AI Database | `skills/ai/SKILLS.md` |
 | JDBC, connection pooling, JSON, XML, spatial, full-text, transactions, property graphs | `skills/appdev/` |
 | RAC, CDB/PDB, Exadata, In-Memory, OCI, ATP/ADW, Data Guard | `skills/architecture/` |
 | ERD, data modeling, partitioning, tablespaces | `skills/design/` |
@@ -31,13 +32,14 @@ A collection of 128 standalone reference guides for Oracle Database and OCR data
 | Privileges, VPD, TDE, encryption, auditing, network security | `skills/security/` |
 | SQL patterns, window functions, CTEs, dynamic SQL, injection | `skills/sql-dev/` |
 | SQLcl commands, scripting, Liquibase CLI, MCP server, CI/CD | `skills/sqlcl/` |
-| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/` |
+| Oracle Container Registry images, container pull commands, tags, and OCR repository selection | `skills/containers/SKILLS.md` |
 
 ## Skills Directory
 
 ```
 skills/
 ├── admin/          Database administration (backup, recovery, users, redo/undo)
+├── ai/             AI Database topics (Select AI, AI Agent, AI Vector Search, RAG guidance)
 ├── appdev/         Application development (JSON, XML, spatial, text, pooling)
 ├── architecture/   Infrastructure (RAC, Multitenant, Exadata, In-Memory, OCI)
 ├── containers/     OCR Database-category container repositories
@@ -56,6 +58,10 @@ skills/
 
 ## Key Starting Points
 
+- **`skills/ai/SKILLS.md`** — task router for the AI category
+- **`skills/ai/ai-vector-search.md`** — entry point for Oracle AI Vector Search concepts and routing
+- **`skills/ai/select-ai.md`** — entry point for Select AI concepts and routing
+- **`skills/ai/select-ai-python.md`** — routing between `select_ai`, SQL, and PL/SQL Select AI use from Python
 - **`skills/sqlcl/sqlcl-mcp-server.md`** — connecting AI assistants to Oracle via the SQLcl MCP server
 - **`skills/migrations/migration-assessment.md`** — start here for any database migration project
 - **`skills/performance/explain-plan.md`** — foundation for all SQL performance work