address comments + blog cover + changelog entry

Author: atharvadeosthale

.optimize-cache.json

@@ -632,6 +632,7 @@
   "images/blog/integrations-messaging/cover.png": "22f32d8be6585e781214a9c083c86d7d5021babd7604f6e9c8819c2c91e2dfe0",
   "images/blog/introducing-appwrite-react-native-sdk/appwrite.png": "fd428e8859e29c7698a8c7193e7efb8af4ed80c0bfc24418cd9446a96b75fba4",
   "images/blog/introducing-appwrite-react-native-sdk/cover.png": "7a45ea7049ee661e9143c89998060638d20c1242162154550ec7fe1127c08242",
+  "images/blog/introducing-appwrite-skills/cover.png": "4e106084bfb0e22b9833dfdc9cfd2e10a32de21d37fe45a132286e9848357054",
   "images/blog/introducing-database-backups/cover.png": "0513bcc80f2aced49c5acc4d634883c860940196c914c309f3517b97e003affd",
   "images/blog/introducing-imagine/cover.png": "f43476c4b5609960c00245c814c7ea9555dcbd0b1e638a58b06ebb8524850492",
   "images/blog/introducing-imagine/imagine-1.png": "58c6e736e8c5a5cae752097defce06b30482057dfc56096ce827dee68e9b7fdf",
@@ -1345,6 +1346,10 @@
   "images/docs/sites/redeploy.png": "f4a4fe1ba45a02ddd7513c66f966ccc89b747d1dded7ce732858a03952a867f3",
   "images/docs/sites/site-templates.png": "f6886138f4a6d17b245c4d23dc9e8a2908d5f4eea3a4337d9f73220b4ad3b889",
   "images/docs/sites/timeout.png": "aef6461e4d4e929f45e435d25378c937e5706cc1ed1faacbb577d815482a43e1",
+  "images/docs/skills/method.png": "980b5054c4aebe443993bb32bb069a532f54c345804f40c36b2901338ef598ef",
+  "images/docs/skills/scope.png": "f031aa64b0d8b5d84bc514f742a9aa4f049aa1ad3366a6fe79eb8281dafaf142",
+  "images/docs/skills/skills.png": "05c95624d7670d39da107c441156eb62fa3b0827f5dbd845ee388163932471da",
+  "images/docs/skills/tools.png": "5e70fc0bd2ead04ce1b8986f438a3af6ba54133ec88295223c59731e969ec964",
   "images/docs/storage/copy-file-token-url.png": "c3e0636256aa626b9e636794dd9c7beef1e6dd3fef9e879be1d51205dda6186a",
   "images/docs/storage/create-bucket.png": "910cc635a1df6c523d77558cdf868669ed6e244584c9f8161dbc258419ce14bb",
   "images/docs/storage/create-file-token.png": "b96a38c5d335492aa9916a00a58785499083190165f1e47129733dd9dbf695d4",

src/routes/blog/post/announcing-appwrite-skills/+page.markdoc

@@ -1,9 +1,9 @@
 ---
 layout: post
-title: "Announcing Appwrite Skills: Give your AI agents Appwrite expertise"
+title: "Introducing Appwrite Skills: Give your AI agents Appwrite expertise"
 description: Appwrite Skills are open source markdown files that give AI agents deep, language-specific knowledge of Appwrite SDKs. Install once, and your agents generate correct Appwrite code automatically.
-date: 2026-03-06
-cover: /images/blog/ai-announcement.png
+date: 2026-03-09
+cover: /images/blog/introducing-appwrite-skills/cover.png
 timeToRead: 4
 author: atharva
 category: product, announcement
@@ -36,9 +36,8 @@ Here's what that means for you:
 
 # Supported SDKs
 
-Skills are available for all major Appwrite SDKs:
+Skills are available for the Appwrite CLI and all major SDKs:
 
-- CLI
 - TypeScript
 - Dart
 - .NET

src/routes/changelog/(entries)/2026-03-09.markdoc

@@ -0,0 +1,20 @@
+---
+layout: changelog
+title: "Introducing Appwrite Skills"
+date: 2026-03-09
+cover: /images/blog/introducing-appwrite-skills/cover.png
+---
+
+Appwrite Skills are open-source Markdown files that give AI coding agents deep, language-specific knowledge of Appwrite SDKs. Install skills into your project, and your AI tools generate correct Appwrite code automatically, no more pasting docs into prompts.
+
+Skills are available for the Appwrite CLI and all major SDKs, including TypeScript, Dart, .NET, Go, Kotlin, PHP, Python, Ruby, and Swift. They work with Claude Code, Cursor, Windsurf, and other compatible agents.
+
+Get started with one command:
+
+```bash
+npx skills add appwrite/agent-skills
+```
+
+{% arrow_link href="/blog/post/announcing-appwrite-skills" %}
+Read the announcement to learn more
+{% /arrow_link %}

src/routes/docs/tooling/skills/+page.markdoc

@@ -4,9 +4,16 @@ title: Skills
 description: Install Appwrite skills to give AI agents pre-built knowledge of Appwrite SDKs and services for your preferred language.
 ---
 
-Skills are open source markdown files that give AI agents deep knowledge of Appwrite SDKs and services. When installed, skills provide your AI tools with accurate, language-specific context about Appwrite APIs, so they generate correct code without needing to look up documentation. You can find all Appwrite skills on [GitHub](https://github.com/appwrite/agent-skills/).
+Skills are open-source Markdown files that give AI agents deep knowledge of Appwrite SDKs and services. When installed, skills provide your AI tools with accurate, language-specific context about Appwrite APIs, so they generate correct code without needing to look up documentation. You can find all Appwrite skills on [GitHub](https://github.com/appwrite/agent-skills/).
 
-Skills work across all major AI dev tools that support them, including Claude Code, Cursor, and other compatible agents. They are installed per-project or globally, and are available for all Appwrite client and server SDKs.
+Skills work across all major AI dev tools that support them. They are installed per-project or globally, and are available for all Appwrite client and server SDKs. Supported tools include but not limited to:
+
+- Cursor
+- Claude Code
+- Windsurf Editor
+- Google Antigravity
+- OpenCode
+- *and more...*
 
 # Benefits {% #benefits %}
 
@@ -27,9 +34,8 @@ npx skills add appwrite/agent-skills
 {% /section %}
 
 {% section #step-2 step=2 title="Select skills" %}
-You will be prompted to select which skills to install. Skills are available for the following SDKs:
+You will be prompted to select which skills to install. Skills are available for the Appwrite CLI and the following SDKs:
 
-- CLI
 - TypeScript
 - Dart
 - .NET
@@ -41,19 +47,27 @@ You will be prompted to select which skills to install. Skills are available for
 - Swift
 
 Select the skills that match the SDKs you use in your project.
+
+![Skill selection prompt](/images/docs/skills/skills.png)
 {% /section %}
 
 {% section #step-3 step=3 title="Select tools" %}
 Choose which AI tools should use the installed skills. This configures the skills for the agents you work with.
+
+![Tool selection prompt](/images/docs/skills/tools.png)
 {% /section %}
 
 {% section #step-4 step=4 title="Select scope" %}
 Choose whether to install the skills at the **project** level or **globally**:
 
 - **Project**: Skills are available only in the current project. This is useful when different projects use different Appwrite SDKs.
 - **Global**: Skills are available across all your projects. This is useful if you use the same SDKs everywhere.
+
+![Scope selection prompt](/images/docs/skills/scope.png)
 {% /section %}
 
 {% section #step-5 step=5 title="Choose installation method" %}
-Select **symlink** as the installation method. This creates a symbolic link to the skills, so they stay up to date when the source is updated.
+Select **symlink** as the installation method. This creates a symbolic link to the skills, so they stay in sync across all your AI tools.
+
+![Installation method prompt](/images/docs/skills/method.png)
 {% /section %}