From e55d8b283ba0f97e7e6bda1bb147431f4ab029c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Enrique=20Lo=CC=81pez=20Man=CC=83as?=
 <eenriquelopez@gmail.com>
Date: Tue, 24 Mar 2026 08:06:44 +0100
Subject: [PATCH] docs: add AI contribution guidelines and .geminiignore

---
 .geminiignore   | 40 ++++++++++++++++++++++++++++++++++++++++
 CONTRIBUTING.md |  6 ++++++
 2 files changed, 46 insertions(+)
 create mode 100644 .geminiignore

diff --git a/.geminiignore b/.geminiignore
new file mode 100644
index 00000000..ecfe6dd6
--- /dev/null
+++ b/.geminiignore
@@ -0,0 +1,40 @@
+# Ignore build and generated directories
+build/
+**/build/
+.gradle/
+.idea/
+.kotlin/
+.vscode/
+
+# Ignore outputs
+*.apk
+*.ap_
+*.aab
+*.dex
+*.class
+
+# Ignore large media assets (images, fonts, etc) unless specifically required
+**/*.png
+**/*.jpg
+**/*.jpeg
+**/*.gif
+**/*.webp
+**/*.svg
+**/*.mp4
+**/*.mp3
+**/*.wav
+**/*.ttf
+**/*.woff
+**/*.woff2
+**/*.otf
+
+# Ignore temporary and cache files
+tmp/
+**/tmp/
+*.log
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.DS_Store
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4e673a07..69ae2d8d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -26,6 +26,12 @@ information on using pull requests.
 
 Reviews will undergo strict enforcement of the [Jetpack Compose API guidelines](https://github.com/androidx/androidx/blob/androidx-main/compose/docs/compose-api-guidelines.md).
 
+## Using AI to Contribute
+
+This repository provides an official Gemini Skill to help AI agents navigate and contribute to the project effectively. If you are using the `gemini-cli` or a compatible AI tool, you can invoke the skill located in `.gemini/skills/android-maps-compose` to learn how to integrate or modify the Maps Compose components. 
+
+Additionally, the `.geminiignore` file prevents AI tools from consuming large or irrelevant files to preserve context limits.
+
 ## Community Guidelines
 
 This project follows