From 6168c8ffe940133daaf398b5a60c5b5229f9e843 Mon Sep 17 00:00:00 2001
From: Workflows Directory <127676627+workflowsdir@users.noreply.github.com>
Date: Thu, 9 Apr 2026 16:01:48 -0300
Subject: [PATCH] docs: add comprehensive description to database-design skill
 for better discoverability

Updated SKILL.md and ARCHITECTURE.md with a more informative description to resolve issue #70.
---
 .agent/ARCHITECTURE.md                 | 4 ++--
 .agent/skills/database-design/SKILL.md | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.agent/ARCHITECTURE.md b/.agent/ARCHITECTURE.md
index 99ca60a1b..035f38650 100644
--- a/.agent/ARCHITECTURE.md
+++ b/.agent/ARCHITECTURE.md
@@ -84,7 +84,7 @@ Modular knowledge domains that agents can load on-demand. based on task context.
 
 | Skill             | Description                 |
 | ----------------- | --------------------------- |
-| `database-design` | Schema design, optimization |
+| `database-design` | Schema design, architecture selection, ORM optimization, and migration procedures |
 | `prisma-expert`   | Prisma ORM, migrations      |
 
 ### TypeScript/JavaScript
@@ -217,7 +217,7 @@ skill-name/
 
 ---
 
-## � Scripts (2)
+##  Scripts (2)
 
 Master validation scripts that orchestrate skill-level scripts.
 
diff --git a/.agent/skills/database-design/SKILL.md b/.agent/skills/database-design/SKILL.md
index 40c24a0b3..b8d903588 100644
--- a/.agent/skills/database-design/SKILL.md
+++ b/.agent/skills/database-design/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: database-design
-description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
+description: Expert guidance on database design, architecture selection (SQL/NoSQL/Serverless), ORM optimization (Prisma, Drizzle), schema normalization, indexing strategies, and safe migration procedures.
 allowed-tools: Read, Write, Edit, Glob, Grep
 ---