💡 Why Skills Win:

• Auto-activate — loads only when your code context is relevant
• Portable — works across Copilot, Claude, Cursor, Gemini CLI
• Composable — install multiple skills, they don't conflict
• Community-driven — share & install via agentskills install

🔌 MCP + Skills = Supercharged Agents

MCP gives agents hands (tools to act). Skills give agents brains (knowledge to decide). Together, your AI assistant knows what to do AND how to do it right.

💡 What are Skills?

From Anthropic's official docs: "Skills extend what Claude can do. Create a SKILL.md file with instructions, and Claude adds it to its toolkit. Claude uses skills when relevant, or you can invoke one directly."

Skills follow the open Agent Skills standard — works across GitHub Copilot, Claude Code, Cursor, Gemini CLI, and more!

// Creating a container for an e-commerce app
const container = await database.containers.createIfNotExists({
    id: "orders",
    partitionKey: { paths: ["/id"] }  // 🤔 Hmm...
});

// Querying all orders for a customer
const query = `SELECT * FROM c WHERE c.customerId = '${customerId}'`;
// Cross-partition query! 💸 Costs 10x more RUs

🎯 Reveal the Answer!

🗣️ What developers say on Twitter/Reddit:

• "Cosmos DB is too expensive!"
• "My RU costs exploded overnight"
• "I got a $5,000 bill for a simple CRUD app"
• "Just use Postgres, it's cheaper"

🔍 The Real Problem — It's Not Cosmos DB, It's the Configuration:

Pain Point	Root Cause	Agent Kit Fix
💸 High RU costs	Cross-partition queries, bad indexing	Rules catch these at code-time
🐌 Slow queries	Missing composite indexes, full scans	Auto-suggests optimal indexes
🔥 Hot partitions	Low-cardinality partition keys	Warns about poor key choices
📈 Unpredictable scaling	Manual throughput, no autoscale	Recommends autoscale patterns
🤯 Steep learning curve	Too many knobs to tune	180 rules = instant expertise

✅ The Truth: Cosmos DB is incredibly powerful — but only if configured right. The Agent Kit ensures your AI assistant guides you to the optimal setup from day one.

💡 Most "expensive" Cosmos DB deployments are just misconfigured ones.

// Developer writes this code...

 

const container = database.container("users");

const { resources } = await container.items

  .query("SELECT * FROM c")

  .fetchAll();

 

// 🤖 Agent Kit activates automatically...

// ⚠️ Rule: "Avoid SELECT * — specify only needed fields"

// ⚠️ Rule: "Use .fetchNext() with pagination for large datasets"

// ⚠️ Rule: "Always handle continuation tokens"

// ✅ Suggested fix provided inline...

🎯 What to watch for in the demo:

1. Auto-detection — Agent recognizes Cosmos DB SDK usage
2. Contextual rules — Only relevant rules activate (not all 180!)
3. Inline suggestions — Fix appears right where you're coding
4. Explanation — Agent explains why the fix matters (RU savings, performance)
5. Best practice code — Complete corrected snippet generated

💡 Demo scenarios:

• 🔑 Partition key selection for a new container
• ⚡ Query optimization with proper indexing
• 🔒 Security review — connection string vs managed identity
• 📐 Data modeling — embed vs reference decision