Standardize Oz web app procedures

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: rachaelrenk

src/assets/agent-platform/oz-web-app-new-agent.png

@@ -73,9 +73,9 @@ You can also search by title, prompt, or agent name, and add advanced filters fo
 
 Click **New run** in the header to start a cloud agent.
 
-1. **Select an agent (optional)** — Choose **Quick run** to run as yourself, or choose a saved agent from the **Agent** dropdown.
-2. **Select an environment** — Choose which environment the agent runs in.
-3. **Add a prompt** — Provide context and instructions for this specific run.
+1. Select an agent, if needed. Choose **Quick run** to run as yourself, or choose a saved agent from the **Agent** dropdown.
+2. Select the environment where the agent should run.
+3. Add a prompt with context and instructions for this specific run.
 
 **Quick run** runs as your own user. A saved agent uses its saved defaults, and your prompt adds context for this particular execution.
 
@@ -109,11 +109,11 @@ Click any agent to view its details, then click **New run** to start a run from
 
 ### Creating a new agent
 
-Click **New agent** to open the side pane.
+To create a saved agent:
 
-1. **Click New agent** — Open the guided creation flow.
-2. **Define instructions and defaults** — Add a name, description, prompt, optional skills, harness, model, environment, and secrets.
-3. **Click Create agent** — Save the agent so it appears on the Agents page and is available for future runs.
+1. Click **New agent** to open the guided creation flow.
+2. Define the instructions and defaults. Add a name, description, prompt, optional skills, harness, model, environment, and secrets.
+3. Click **Create agent**. The saved agent appears on the Agents page and is available for runs.
 
 For deeper guidance on reusable skills and team-scoped identities, see [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) and [Agent identities](/agent-platform/cloud-agents/agents/).
 
@@ -134,11 +134,17 @@ Click any skill to view its details, then click **New run** to start a run with
 
 ### Creating a skill for agents
 
-Click **New agent** on the Skills page to open the skill creation flow.
+To create a skill for agents:
 
-1. **Choose a repository** — Select a repository from an existing environment with GitHub access.
-2. **Define the skill** — Add a skill name, description, and instructions.
-3. **Open a Skill PR** — Create a pull request that adds the skill to the selected repository.
+1. Click **New agent** on the Skills page to open the skill creation flow.
+2. Choose a repository from an existing environment with GitHub access.
+3. Define the skill. Add a skill name, description, and instructions.
+4. Click **Open Skill PR** to create a pull request that adds the skill to the selected repository.
+
+<figure>
+![Creating a skill for agents in the Oz web app.](../../../../assets/agent-platform/oz-web-app-new-skill.png)
+<figcaption>Creating a skill in the Oz web app.</figcaption>
+</figure>
 
 After the PR is merged, refresh skills so the new skill appears in the Oz web app.
 
@@ -159,13 +165,15 @@ Each schedule displays:
 
 ### Creating a schedule
 
-Click **New schedule** in the header to create a scheduled agent.
+To create a scheduled agent:
 
-1. **Name** — Give the schedule a descriptive name.
-2. **Frequency** — Set the cron schedule, with presets for common patterns.
-3. **Environment** — Select the environment to run in.
-4. **Agent (optional)** — Choose a saved agent to use.
-5. **Prompt** — Define what the agent should do each time it runs.
+1. Click **New schedule** in the header.
+2. Name the schedule. Use a descriptive name that explains what the scheduled agent does.
+3. Set the frequency. Choose a preset or enter a cron schedule.
+4. Select the environment where the scheduled agent should run.
+5. Choose a saved agent, if needed.
+6. Add the prompt that the agent should follow each time it runs.
+7. Click **Create schedule**. The schedule appears on the Schedules page.
 
 ### Managing schedules
 
@@ -197,12 +205,14 @@ Each environment displays:
 
 ### Creating an environment
 
-Click **New environment** in the header to create a new environment.
+To create a new environment:
 
-1. **Name** — Give the environment a descriptive name.
-2. **Docker image** — Specify a Docker image. Warp provides prebuilt dev images, or you can use your own.
-3. **Repositories** — Add GitHub repos the agent should have access to.
-4. **Setup commands** — Define commands to run when the environment starts, such as `npm install`.
+1. Click **New environment** in the header.
+2. Name the environment. Use a descriptive name that explains the runtime context.
+3. Select the repositories the agent should be able to access.
+4. Choose a Docker image. Warp provides prebuilt dev images, or you can use your own.
+5. Add any setup commands that should run when the environment starts, such as `npm install`.
+6. Click **Create environment**. The environment appears on the Environments page.
 
 :::note
 For advanced environment configuration, see [Environments](/agent-platform/cloud-agents/environments/) and the [CLI reference](/reference/cli/integration-setup/).