Skip to content

Commit 7606a1d

Browse files
authored
chore: Update the skills readme with instructions (#4484)
1 parent cca59aa commit 7606a1d

1 file changed

Lines changed: 21 additions & 19 deletions

File tree

skills/README.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -6,25 +6,6 @@ This directory contains a suite of AI Agent "Skills" configured to help agents u
66

77
These skills are designed hierarchically to guide the LLM agent from a broad user intent down to the specific technical implementation steps.
88

9-
```text
10-
skills/ # Suite of AI Agent "Skills" for Vertex AI
11-
├── README.md # This developer guide
12-
├── vertex-ai/ # Primary router for Vertex AI tasks
13-
│ └── SKILL.md # Entry point that routes across capabilities
14-
├── genai-sdk/ # Gemini API usage with Gen AI SDK
15-
│ └── SKILL.md # Guides for Python, JS/TS, Go, Java, C#
16-
├── vertex-deploy/ # Deploying models to Endpoints
17-
│ └── SKILL.md # Commands for open models & custom weights
18-
├── vertex-inference/ # Inferencing with GenAI models
19-
│ └── SKILL.md # Code samples for Gemini and OpenMaaS
20-
└── vertex-tuning/ # Secondary router for model fine-tuning
21-
├── SKILL.md # Router for tuning tasks
22-
├── gemini/ # Fine-tuning first-party Gemini models
23-
│ └── SKILL.md
24-
└── open-model/ # Fine-tuning third-party open models
25-
└── SKILL.md
26-
```
27-
289
### Primary Router: `vertex-ai`
2910
The entry point for any general Vertex AI task. The `vertex-ai/SKILL.md` file acts as a traffic controller. When an agent receives a generic request (e.g., "I want to use Vertex AI"), it reads this file to determine the next step based on a Decision Tree:
3011
- **Deploying a model** → Routes to `vertex-deploy`
@@ -58,6 +39,27 @@ Agent skills are essentially specialized prompt contexts. When building agents (
5839
3. **Navigate:** The LLM actively uses file-reading tools to navigate to the correct underlying `SKILL.md` (e.g., `skills/vertex-inference/SKILL.md`).
5940
4. **Execute:** The agent reads the highly-detailed instructions, caveats, and code snippets in the sub-skill to fulfill the user's request.
6041

42+
## Installation & Usage
43+
44+
To use these skills with your AI agent:
45+
46+
1. **Clone the Repository**: Clone this repository to your local development environment or production workspace.
47+
2. **Expose to Agent**: Ensure the `skills/` directory is accessible to your AI assistant. This typically involves mounting or copying the folder into your agent's workspace (e.g., `.agents/skills/` or equivalent custom routing directory).
48+
3. **Trigger the Skills**: Prompt your agent with a Vertex AI related task. The agent should automatically scan for skills, find the primary `vertex-ai/SKILL.md` router, and follow the documented workflow.
49+
50+
### Example Prompts
51+
52+
Here are some example prompts you can use to trigger the routing logic and test the skills:
53+
54+
**Testing Deployment:**
55+
> "I want to deploy a Llama 3.3 model from Model Garden to a Vertex AI endpoint. Can you help me write the script?"
56+
57+
**Testing Inference (Gen AI SDK):**
58+
> "Can you show me how to connect to Vertex AI and get text embeddings using the new Gemini SDK?"
59+
60+
**Testing Tuning:**
61+
> "I need to fine-tune a Gemini 1.5 Pro model using Vertex AI. Where should I start?"
62+
6163
## How to Add a New Skill
6264

6365
If Vertex AI introduces a new capability (e.g., Vertex AI Search or Vertex AI Pipelines) and you want to teach the agent to handle it:

0 commit comments

Comments
 (0)