docs: reformat the gemini.md as skill

Move the AI markdown files into .agent folder and format the content as
a skill so the AI agent can auto pickup the skill

use /gemini to start

Tested: N/A
Change-Id: Ida866b7ef1dbdb8ab7968429e24b10b1079cdc1f
Signed-off-by: Hao Jiang <jianghao@google.com>
diff --git a/build.md b/.agents/skills/compile/SKILL.md
similarity index 87%
rename from build.md
rename to .agents/skills/compile/SKILL.md
index 6902b21..9171e10 100644
--- a/build.md
+++ b/.agents/skills/compile/SKILL.md
@@ -1,3 +1,10 @@
+---
+name: compile
+description:
+  Instructions and commands for configuring, compiling, building, and running
+  tests inside the OpenBMC Docker container using Meson.
+---
+
 ## Compile and Test Environment
 
 If the Antigravity/Gemini console/server is not running in the OpenBMC unittest
diff --git a/gemini.md b/.agents/skills/gemini/SKILL.md
similarity index 86%
rename from gemini.md
rename to .agents/skills/gemini/SKILL.md
index 7a58a98..ca563e5 100644
--- a/gemini.md
+++ b/.agents/skills/gemini/SKILL.md
@@ -1,3 +1,10 @@
+---
+name: gemini
+description:
+  High-level workflow, project guidelines, implementation, testing, and commit
+  conventions for Gemini/AI coding assistant when working on dbus-sensors.
+---
+
 # Gemini Coding Assistant Project Guidelines
 
 ## High-Level Flow
@@ -22,7 +29,8 @@
 Agent should use the following source as reference:
 
 - workspace files
-- Use the build.md to configure the Meson. Use the `subprojects` directory.
+- Use the compile skill (.agents/skills/compile/SKILL.md) to configure Meson and
+  build inside Docker. Use the `subprojects` directory.
 - Refer to the docker system file for include headers.
 
 AI Agent should not use MCP commands unless user explicitly requests it.
@@ -45,8 +53,9 @@
 AI Agent should act as a senior software engineer to implement the solution. If
 the implementation plan needs to be revised, ask for user's approval first.
 
-AI Agent should compile the code in the docker container based on `build.md` and
-make sure the code compiles successfully.
+AI Agent should compile the code in the docker container based on the compile
+skill (`.agents/skills/compile/SKILL.md`) and make sure the code compiles
+successfully.
 
 AI Agent should use `.clang-format` to format the code before compiling.
 
@@ -56,8 +65,8 @@
 If any unit test case fails, fix it and recompile, and test again. Agent should
 not run shortcut and alter the test cases in the plan.
 
-Setup a subagent based on the implementation plan and lesson.md file to review
-the code changes.
+Setup a subagent based on the implementation plan and lesson skill
+(`.agents/skills/lesson/SKILL.md`) to review the code changes.
 
 ## Local Presubmit and Commit
 
diff --git a/lesson.md b/.agents/skills/lesson/SKILL.md
similarity index 94%
rename from lesson.md
rename to .agents/skills/lesson/SKILL.md
index 443d2c2..d8af07e 100644
--- a/lesson.md
+++ b/.agents/skills/lesson/SKILL.md
@@ -1,3 +1,10 @@
+---
+name: lesson
+description:
+  C++ best practices, common pitfalls, coroutine safety, and testing/debugging
+  lessons learned for the dbus-sensors codebase.
+---
+
 ## C++ Best Practices
 
 ### State Machine for Asynchronous Queries