Skip to content

Commit 4420f0c

Browse files
rachaelrenkoz-agent
andcommitted
fix: sentence case corrections and skill update for casing rules
- Fix title case → sentence case in titles and sidebar labels: computer-use, web-search, api-keys, mcp-servers, network-log, known-issues - Simplify integration titles: remove 'for Oz' suffix (azure-devops, bitbucket, gitlab, linear, slack) - Add key principle #6 to SEO audit skill with explicit sentence case rule and ✅/❌ examples to prevent future casing mistakes Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 20997c0 commit 4420f0c

12 files changed

Lines changed: 25 additions & 12 deletions

File tree

.agents/skills/docs-seo-audit/SKILL.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,19 @@ Before making any changes, read these references:
119119
3. **OG and Twitter tags mirror title and description** automatically. No separate fix needed.
120120
4. **Changing a sidebar config label has side effects**: it also changes the sidebar label, breadcrumbs, and prev/next pagination. URLs are NOT affected (URLs are based on the file path/slug).
121121
5. **When changing a title, also update the H1** in the markdown file for consistency.
122+
6. **All titles, labels, and H1 headings must use sentence case.** Capitalize only the first word and proper nouns. Only recognized proper feature names retain their capitalization — check `AGENTS.md` and `.agents/references/terminology.md` for the canonical list. Common mistakes to avoid:
123+
-`Computer use for agents` — generic term, sentence case
124+
-`Computer Use for Agents` — not a proper feature name, don't capitalize
125+
-`API keys` — generic term, sentence case
126+
-`API Keys` — not a proper feature name
127+
-`Known issues` — generic term, sentence case
128+
-`Known Issues` — not a proper feature name
129+
-`Slack integration` — external product name (Slack) + generic term
130+
-`Slack Integration for Oz` — "Integration" is not a proper feature name; "for Oz" is imprecise (see terminology rules)
131+
-`Agent Mode` — proper feature name, retains capitalization
132+
-`Codebase Context` — proper feature name, retains capitalization
133+
-`Tab Configs` — proper feature name, retains capitalization
134+
-`Warp Drive` — proper feature name, retains capitalization
122135

123136
### Title exceptions
124137

src/content/docs/agent-platform/capabilities/computer-use.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Computer Use for agents
2+
title: Computer use for agents
33
sidebar:
44
label: "Computer use"
55
description: >-

src/content/docs/agent-platform/capabilities/web-search.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Agent Web Search
2+
title: Agent web search
33
sidebar:
44
label: "Web search"
55
description: >-

src/content/docs/agent-platform/cloud-agents/integrations/azure-devops.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Azure DevOps integration for Oz
2+
title: Azure DevOps integration
33
sidebar:
44
label: "Azure DevOps"
55
description: >-

src/content/docs/agent-platform/cloud-agents/integrations/bitbucket.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Bitbucket integration for Oz
2+
title: Bitbucket integration
33
sidebar:
44
label: "Bitbucket"
55
description: >-

src/content/docs/agent-platform/cloud-agents/integrations/gitlab.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: GitLab integration for Oz
2+
title: GitLab integration
33
sidebar:
44
label: "GitLab"
55
description: >-

src/content/docs/agent-platform/cloud-agents/integrations/linear.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Linear integration for Oz
2+
title: Linear integration
33
sidebar:
44
label: "Linear"
55
description: >-

src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Slack integration for Oz
2+
title: Slack integration
33
sidebar:
44
label: "Slack"
55
description: >-

src/content/docs/reference/cli/api-keys.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: API keys for the Oz CLI
33
description: >-
44
Create and manage API keys for authenticating the Oz CLI and cloud agents.
55
sidebar:
6-
label: "API Keys"
6+
label: "API keys"
77
---
88

99
API keys let the Oz CLI and cloud agents authenticate without human interaction. Use API keys for CI pipelines, headless servers, VMs, Codespaces, containers, and other automated environments.

src/content/docs/reference/cli/mcp-servers.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: >-
44
Connect agents to external tools like GitHub, Linear, and Sentry by passing
55
MCP servers to the --mcp flag as a UUID, inline JSON, or file path.
66
sidebar:
7-
label: "MCP Servers"
7+
label: "MCP servers"
88
---
99

1010
MCP servers connect agents to external systems like GitHub, Linear, or Sentry. To use a [Model Context Protocol (MCP)](/agent-platform/capabilities/mcp/) server from the CLI, use the `--mcp` flag with `oz agent run` or `oz agent run-cloud`.

0 commit comments

Comments
 (0)