Skip to content

Commit bd59d45

Browse files
fukoudafukouda
committed
refactor(docs): reorganize skills documentation and update navigation
1 parent 523c719 commit bd59d45

19 files changed

Lines changed: 70 additions & 39 deletions

‎components/layouts/docs.tsx‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ export function DocsLayout({ tree, children, stars }: DocsLayoutProps) {
150150
<SearchToggle />
151151
<Button
152152
asChild
153-
className="bg-yellow-300 font-mono text-neutral-900 flex items-baseline gap-0.5 px-2 xl:px-3 py-2 hover:bg-yellow-400 transition-colors duration-200 group hidden xl:flex shrink-0"
153+
className="bg-yellow-300 font-mono text-neutral-900 hidden items-baseline gap-0.5 px-2 xl:px-3 py-2 hover:bg-yellow-400 transition-colors duration-200 group xl:flex shrink-0"
154154
>
155155
<Link href="https://app.steel.dev" target="_blank">
156156
Sign in
@@ -427,9 +427,10 @@ export function SidebarItem({
427427

428428
if (item.type === 'separator') {
429429
return (
430-
<p className="text-primary uppercase text-[0.75rem] leading-none tracking-wide font-mono font-bold mt-6 mb-2 first:mt-0 px-2">
431-
{item.name}
432-
</p>
430+
<div className="text-primary uppercase text-[0.75rem] leading-none tracking-wide font-mono font-bold mt-6 mb-2 first:mt-0 px-2 flex items-center gap-2">
431+
<span>{item.name}</span>
432+
<PageBadges item={item} />
433+
</div>
433434
);
434435
}
435436

@@ -504,8 +505,6 @@ export function SidebarItem({
504505
}
505506

506507
export function PageBadges({ item }: { item: PageTree.Node }) {
507-
if (item.type !== 'page') return null;
508-
509508
const badges: React.ReactNode[] = [];
510509

511510
const isNew = (item as any).data?.isNew;

‎components/skill-grid.tsx‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ const SKILLS = [
99
stage: 'GA',
1010
description:
1111
'Live browser tasks: scrape, click, fill forms, capture screenshots, and create PDFs.',
12-
href: '/overview/steel-cli/steel-browser',
12+
href: '/overview/skills/available-skills/steel-browser',
1313
},
1414
{
1515
name: 'steel-developer',
@@ -18,7 +18,7 @@ const SKILLS = [
1818
stage: 'GA',
1919
description:
2020
'Reusable Steel code with SDKs, REST APIs, Playwright, Puppeteer, Stagehand, and Browser Use.',
21-
href: '/overview/steel-cli/steel-developer',
21+
href: '/overview/skills/available-skills/steel-developer',
2222
},
2323
{
2424
name: 'steel-session-debugging',
@@ -27,7 +27,7 @@ const SKILLS = [
2727
stage: 'Beta',
2828
description:
2929
'Failed-session diagnosis from metadata, logs, traces, replay links, and network evidence.',
30-
href: '/overview/steel-cli/steel-session-debugging',
30+
href: '/overview/skills/available-skills/steel-session-debugging',
3131
},
3232
{
3333
name: 'steel-reliability',
@@ -36,15 +36,15 @@ const SKILLS = [
3636
stage: 'Beta',
3737
description:
3838
'Bot-detection, CAPTCHA, proxy, identity, login persistence, pacing, and retry guidance.',
39-
href: '/overview/steel-cli/steel-reliability',
39+
href: '/overview/skills/available-skills/steel-reliability',
4040
},
4141
{
4242
name: 'steel-skill-creator',
4343
title: 'Steel Skill Creator',
4444
category: 'Create',
4545
stage: 'Beta',
4646
description: 'Turn recurring browser workflows into reusable, parameterized agent skills.',
47-
href: '/overview/steel-cli/steel-skill-creator',
47+
href: '/overview/skills/available-skills/steel-skill-creator',
4848
},
4949
];
5050

‎content/docs/integrations/claude-code.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,5 +73,5 @@ After a successful run, Claude Code can help turn the browser workflow into some
7373
* [Claude Code overview](https://code.claude.com/docs/en/overview) – Official Claude Code documentation
7474
* [How Claude Code works](https://code.claude.com/docs/en/how-claude-code-works) – Built-in tools, permissions, and execution model
7575
* [Steel CLI docs](/overview/steel-cli) – Full command reference and workflows
76-
* [Steel Skills](/overview/steel-cli/skills) – Installable skills for coding agents
76+
* [Steel Skills](/overview/skills) – Installable skills for coding agents
7777
* [Steel Discord](https://discord.gg/steel-dev) – Get help and share what you build

‎content/docs/integrations/codex.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,5 +64,5 @@ That works well for jobs like recurring research, internal reporting, or lightwe
6464
* [Codex + Steel + Resend blog post](https://steel.dev/blog/codex-wired-steel-and-resend-into-a-daily-newsletter) – Example workflow for building a daily newsletter with Codex
6565
* [Codex CLI docs](https://developers.openai.com/codex/cli) – Install and use Codex locally
6666
* [Steel CLI docs](/overview/steel-cli) – Full command reference and workflows
67-
* [Steel Skills](/overview/steel-cli/skills) – Installable skills for coding agents
67+
* [Steel Skills](/overview/skills) – Installable skills for coding agents
6868
* [Steel Discord](https://discord.gg/steel-dev) – Get help and share what you build

‎content/docs/integrations/openclaw.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,5 +91,5 @@ See:
9191

9292
* [OpenClaw + Steel blog post](https://steel.dev/blog/openclaw-steel-browser-let-your-ai-agent-fill-the-forms) – Case study using OpenClaw to work through a CFP submission flow
9393
* [Steel CLI docs](/overview/steel-cli) – Full command reference and workflows
94-
* [Steel Skills](/overview/steel-cli/skills) – Installable skills for coding agents
94+
* [Steel Skills](/overview/skills) – Installable skills for coding agents
9595
* [Steel Discord](https://discord.gg/steel-dev) – Get help and share what you build

‎content/docs/overview/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
"need-help",
1010
"pricinglimits",
1111
"...guides",
12+
"...skills",
1213
"...sessions-api",
1314
"...agent-traces",
1415
"...credentials-api",

content/docs/overview/steel-cli/skill-catalog.mdx renamed to content/docs/overview/skills/available-skills/index.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Skill Catalog
2+
title: Available Skills
33
description: Choose the Steel Skill that matches your agent workflow.
44
llm: true
55
---
@@ -25,10 +25,10 @@ For Claude Code plugin installs, add the marketplace once and install by skill n
2525

2626
## Choosing a skill
2727

28-
| Intent | Primary Skill |
29-
| --- | --- |
30-
| Browse, click, scrape, screenshot, or create a PDF now | `steel-browser` |
31-
| Write reusable Steel code | `steel-developer` |
32-
| Diagnose a failed session | `steel-session-debugging` |
33-
| Mitigate bot detection, CAPTCHA, proxy, identity, or login reliability | `steel-reliability` |
34-
| Turn a recurring browser task into a reusable workflow | `steel-skill-creator` |
28+
| Intent | Primary Skill |
29+
| ---------------------------------------------------------------------- | ------------------------- |
30+
| Browse, click, scrape, screenshot, or create a PDF now | `steel-browser` |
31+
| Write reusable Steel code | `steel-developer` |
32+
| Diagnose a failed session | `steel-session-debugging` |
33+
| Mitigate bot detection, CAPTCHA, proxy, identity, or login reliability | `steel-reliability` |
34+
| Turn a recurring browser task into a reusable workflow | `steel-skill-creator` |

‎content/docs/overview/skills/available-skills/meta.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"title": "Available Skills",
3+
"defaultOpen": true,
4+
"pages": [
5+
"steel-browser",
6+
"steel-developer",
7+
"steel-reliability",
8+
"steel-session-debugging",
9+
"steel-skill-creator"
10+
]
11+
}

content/docs/overview/steel-cli/steel-browser.mdx renamed to content/docs/overview/skills/available-skills/steel-browser.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: Steel Browser Skill
3+
sidebarTitle: steel-browser
34
description: Use Steel Browser when an agent should operate a live Steel browser now.
45
llm: true
56
---

content/docs/overview/steel-cli/steel-developer.mdx renamed to content/docs/overview/skills/available-skills/steel-developer.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: Steel Developer Skill
3+
sidebarTitle: steel-developer
34
description: Use Steel Developer when an agent should write reusable Steel code, scripts, examples, or app integrations.
45
llm: true
56
---

0 commit comments

Comments
 (0)