updates

Author: johnymontana

.trunk/configs/.vale.ini

@@ -17,5 +17,5 @@ Google.We = OFF
 Google.Passive = OFF
 CommentDelimiters = {/*, */}
 
-[agents/create-agent.mdx]
+[agents/*.mdx]
 Google.Quotes = NO

agents/agent-gallery/music-recommendation.mdx

@@ -0,0 +1,49 @@
+---
+title: "Music Recommendation Agent"
+sidebarTitle: "Music Recommendation Agent"
+description:
+  "Create a music recommendation agent that can recommend music based on your
+  preferences and create new Spotify playlists"
+---
+
+![Music Recommendation Agent](/images/agents/agent-gallery/music-recommendation.png)
+
+## Instructions
+
+```text
+Identity:
+BeatBuddy is a friendly, knowledgeable music recommendation agent that helps users discover new artists,
+create playlists by mood or genre, and suggest songs based on their favorites.
+
+Context:
+BeatBuddy provides general music recommendations, not tied to any specific service or company.
+It can suggest new artists, generate curated playlists for different moods or genres, and
+recommend songs similar to those the user already likes. BeatBuddy's goal is to make
+music discovery fun, personalized, and easy for everyone.
+```
+
+## Connections
+
+- **Spotify** - Spotify is a digital music service that gives you access to
+  millions of songs.
+
+## Example conversation
+
+```text
+Me: Create a playlist with the same beat as Candyman by Xtina. I want it to determine
+the bpm and run a search for similar bpm and then a visual similarity search within that
+of candyman for more pop songs before creating, naming, opening, and playing my new playlist.
+```
+
+```text
+Agent: Here's the plan:
+
+"Candyman" by Christina Aguilera is a pop song with a swing/jazz influence and an energetic,
+upbeat tempo. Its BPM (beats per minute) is widely reported as 172.
+
+I will search for pop songs with a similar BPM (around 170–175) and then filter for those with a similar energetic, retro-pop feel.
+
+I'll create, name, and open your new playlist, then play it for you.
+
+Let's get started!
+```

agents/agent-gallery/social-media.mdx

@@ -6,18 +6,26 @@ description:
   run campaigns based on your products and brand."
 ---
 
+![Example conversation](/images/agents/agent-gallery/social-media-intern.png)
+
 ## Instructions
 
 ```text
 You are a social media expert, skilled at educating developers about deep technical concepts in a format friendly for social media.
+
+Tools:
+- GitHub: Access the user's GitHub repository.
+- Notion: Schedule workouts based on the user's availability.
 ```
 
 ## Connections
 
-- GitHub
-- Notion
-- Ref
+- **GitHub** - GitHub is a web-based Git repository hosting service.
+- **Notion** - Notion is a service for notes, docs, tasks, and databases.
+- **Ref** - Ref is a service for finding references.
 
 ## Example conversation
 
-![Example conversation](/images/agents/agent-gallery/social-media-intern.png)
+```text
+Analyze my hyper-news GitHub repo and create 10-20 social media posts about concepts from the repo, including Dgraph, Modus, and MCP
+```

agents/agent-gallery/workout-scheduling.mdx

@@ -0,0 +1,81 @@
+---
+title: "Workout Scheduling Agent"
+sidebarTitle: "Workout Scheduling Agent"
+description:
+  "Create a workout scheduling agent that can schedule workouts based on your
+  preferences and Strava data and calendar availability."
+---
+
+![Workout Scheduling Agent](/images/agents/agent-gallery/workout-scheduling.png)
+
+## Instructions
+
+```text
+Identity:
+You are PulseCoach, a friendly and knowledgeable personal training advisor.
+
+Context:
+You analyze the user's Strava workout data across all activity types. Your goal is to help the user
+achieve general fitness improvements by reviewing recent workouts, identifying trends, and
+suggesting a balanced, personalized training schedule. Offer clear, actionable advice and
+adapt recommendations based on the user's progress and feedback.
+
+Tools:
+- Strava: Access the user's Strava workout data.
+- Calendar: Schedule workouts based on the user's availability.
+```
+
+## Connections
+
+- **Strava** - Designed by athletes, for athletes, Strava's mobile app and
+  website connect millions of runners and cyclists through the sports they love.
+- **Google Calendar** - Google Calendar is a service for creating, managing, and
+  organizing schedules and events.
+
+## Example conversation
+
+```text
+You: "I want to start running again. Can you help me create a workout schedule?"
+
+Agent: "Based on your recent Strava data, I see you've been consistently running for the past month. I can help you create a personalized workout schedule."
+
+You: "Sounds good. Can you suggest a schedule for the next week?"
+
+Agent: "Here's a suggested workout schedule for the next week:
+
+Monday: Rest day
+Tuesday: 30-minute jog
+Wednesday: Rest day
+Thursday: 45-minute jog
+Friday: Rest day
+Saturday: 1-hour jog
+Sunday: Rest day
+
+I recommend this schedule because it provides a balanced approach to running, with a mix of rest days and active recovery days."
+
+You: "That sounds great. Can you also suggest some tips for running?"
+
+Agent: "Here are some tips for running:
+
+- Stay hydrated
+- Fuel your body with healthy foods
+- Get enough sleep
+- Listen to your body and rest when you need to
+
+I also recommend wearing comfortable shoes and using proper form."
+
+You: "Thanks for the tips. Can you also suggest some tips for running?"
+
+Agent: "Here are some tips for running:
+
+- Stay hydrated
+- Fuel your body with healthy foods
+- Get enough sleep
+- Listen to your body and rest when you need to
+
+I also recommend wearing comfortable shoes and using proper form."
+```
+
+## Tasks
+
+- **Automated Workout Scheduling**

agents/connections.mdx

@@ -50,8 +50,9 @@ tasks, from internal APIs to third-party applications and public resources.
 
 ### Domain-specific tool assignment
 
-Rather than providing agents with access to all available tools, Connections
-uses a curated approach based on the agent's role and domain:
+Rather than providing agents with access to all available tools, Hypermode
+Agents uses a curated approach based on the agent's role and domain. Examples of
+connections relevant for domain specific agents include:
 
 #### Frontend development agent
 
@@ -131,10 +132,22 @@ enhanced tool interaction capabilities:
 
 ### Add a new connection
 
-![Add a new connection](/images/agents/connections-sidebar.png)
+Select a connection from the "add connections"ption from the left navigation bar
+or search from more than 2000 connection options. You'll be prompted to complete
+the OAuth flow if you haven't enabled the connection yet for your workspace.
+
+<img
+  src="/images/agents/connections-sidebar.png"
+  alt="Add a new connection"
+  style={{ width: "100%", maxWidth: "400px" }}
+/>
 
 ### Manage connections
 
+Existing connections can be viewed and managed from the "Connections" tab in the
+Workspace settings page. Connections can also be added to your workspace from
+this page.
+
 ![Manage connections](/images/agents/connections-manage.png)
 
 <Tip>
@@ -153,11 +166,7 @@ Popular integration categories include:
 - **Marketing**: Mailchimp, Constant Contact, Google Ads, Facebook Ads
 - **Productivity**: Slack, Microsoft Teams, Google Workspace, Notion
 
-### Test Integration
-
-Verify that connections work correctly by testing basic operations first.
-
 <Info>
   Custom integrations can be built for internal APIs and proprietary systems.
-  Contact support for assistance with custom connection development.
+  Contact us for assistance with custom connection development.
 </Info>

agents/create-agent.mdx

@@ -6,8 +6,10 @@ description:
   agent's role and objectives."
 ---
 
-Creating an Agent is simple and can be done using the built-in Hypermode
-Concierge agent or by specifying the agent's role and instructions yourself.
+Creating an Agent is simple and can be done
+[using the built-in Hypermode Concierge agent](/agents/create-agent#build-a-new-agent-with-concierge)
+or by
+[specifying the agent's role and instructions yourself](/agents/create-agent#create-an-agent-manually).
 
 ## Build a new agent with Concierge
 
@@ -140,12 +142,7 @@ the agent's instructions, including choosing how to leverage tools.
 Enable connections to allow your agent to access tools and data. This is where
 you define the tools that your agent has access to.
 
-<img
-  height="200"
-  src="/images/agents/manual-create-5.png"
-  alt="Enable connections and start working with your agent"
-  style={{ width: "100%", maxWidth: "400px" }}
-/>
+![Enable connections and start working with your agent](/images/agents/manual-create-5.png)
 
 </Step>
 

agents/example-agents.mdx

@@ -12,13 +12,27 @@ analyze data, and enhance productivity.
 
 <CardGroup cols={2}>
   <Card
-    title="Data Analyst Agent"
+    title="Social Media Agent"
     icon="pen-to-square"
     href="/agents/agent-gallery/social-media"
   >
     Drafts social media content and campaigns based on your products and brand.
   </Card>
 
+  <Card
+    title="Workout Scheduling Agent"
+    icon="calendar"
+    href="/agents/agent-gallery/workout-scheduling"
+  >
+    Schedules workouts based on your availability and Strava data.
+  </Card>
+  <Card
+    title="Music Recommendation Agent"
+    icon="headphones"
+    href="/agents/agent-gallery/music-recommendation"
+  >
+    Recommends music based on your preferences and creates new Spotify playlists.
+  </Card>
 </CardGroup>
 
 ## Getting started

agents/tasks.mdx

@@ -17,8 +17,11 @@ activity as a task by selecting the "Create task" button.
 This turns the thread into a repeatable task that you can use later to automate
 your agent's workflow.
 
-![Create task](/images/agents/create-task.png)
+![Create task](/images/agents/create-task-1.png)
 
 ## Use tasks
 
-After saving a task
+After saving a task to your agent you'll see the task in your agent's task list.
+You can then use the task to automate your agent's workflow.
+
+![Task list](/images/agents/invoke-task.png)