Skip to content

Commit 20579b3

Browse files
dcramerclaude
andcommitted
docs: Restructure install page and update to skills command
Restructure install page information hierarchy: - Add Quick Start section with npx skills as primary method - Elevate Configure Your Project to show it's part of core setup - Group alternatives under Alternative Installation Methods section - Demote Claude marketplace and CLI install to h3 under alternatives Update both homepage and install page to use npx skills instead of npx add-skill. Apply brand guidelines to improve clarity: - Use "or" instead of "and" for agent options (users pick one) - Remove hedging language ("if you prefer") - Make actions more direct ("Enable" vs "Optional") - Split compound sentences for better scannability Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 949a7bf commit 20579b3

2 files changed

Lines changed: 23 additions & 13 deletions

File tree

docs/src/pages/index.astro

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ const base = import.meta.env.BASE_URL.replace(/\/$/, '');
2424

2525
<section class="section">
2626
<h2>Quick Start</h2>
27-
<p>Install dex with add-skill (works with Claude Code, OpenCode, Codex, and Cursor):</p>
27+
<p>Install dex for Claude Code, OpenCode, Codex, or Cursor:</p>
2828
<Terminal title="Terminal" showCopy={true}>
29-
<pre class="cli-output"><span class="cli-dim">$</span> npx add-skill dcramer/dex</pre>
29+
<pre class="cli-output"><span class="cli-dim">$</span> npx skills dcramer/dex</pre>
3030
</Terminal>
3131
<p>Then use <code>/dex</code> to manage tasks. See the <a href={`${base}/install`}>install guide</a> for other installation methods.</p>
3232
</section>

docs/src/pages/install.astro

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,26 +6,36 @@ import Terminal from '../components/Terminal.astro';
66
<Base title="Install" description="Install dex for Claude Code and CLI">
77
<h1>Installation</h1>
88

9-
<h2>Claude Code</h2>
10-
<p>Install the dex plugin from the Claude Code marketplace:</p>
9+
<h2>Quick Start</h2>
10+
<p>Install dex for Claude Code, OpenCode, Codex, or Cursor:</p>
1111
<Terminal title="Terminal" showCopy={true}>
12-
<pre class="cli-output"><span class="cli-dim">$</span> claude plugin marketplace add dcramer/dex
13-
<span class="cli-dim">$</span> claude plugin install dex@dex</pre>
12+
<pre class="cli-output"><span class="cli-dim">$</span> npx skills dcramer/dex</pre>
1413
</Terminal>
15-
<p>The <code>/dex</code> skill will be available immediately.</p>
1614

17-
<h2>Using add-skill</h2>
18-
<p>If you use <a href="https://add-skill.org/">add-skill</a> for installing agent skills:</p>
15+
<h2>Configure Your Project</h2>
16+
<p>Add dex instructions to your project's <code>AGENTS.md</code> or <code>CLAUDE.md</code> file so Claude and other AI agents know to use it for task management:</p>
17+
<Terminal title="AGENTS.md" showCopy={true}>
18+
<pre class="cli-output">## Task Management
19+
Use `/dex` to break down complex work, track progress across sessions, and coordinate multi-step implementations.</pre>
20+
</Terminal>
21+
<p>Place this file in your project root and commit it to version control so your team shares the same context.</p>
22+
23+
<h2>Alternative Installation Methods</h2>
24+
25+
<h3>Claude Code Marketplace</h3>
26+
<p>Install directly from the Claude Code marketplace:</p>
1927
<Terminal title="Terminal" showCopy={true}>
20-
<pre class="cli-output"><span class="cli-dim">$</span> npx add-skill dcramer/dex</pre>
28+
<pre class="cli-output"><span class="cli-dim">$</span> claude plugin marketplace add dcramer/dex
29+
<span class="cli-dim">$</span> claude plugin install dex@dex</pre>
2130
</Terminal>
31+
<p>The <code>/dex</code> skill will be available immediately.</p>
2232

23-
<h2>CLI Only</h2>
24-
<p>Install the CLI globally for standalone use or faster execution:</p>
33+
<h3>Global CLI Install</h3>
34+
<p>Install the CLI globally for direct command-line use or faster execution:</p>
2535
<Terminal title="Terminal" showCopy={true}>
2636
<pre class="cli-output"><span class="cli-dim">$</span> npm install -g @zeeg/dex</pre>
2737
</Terminal>
28-
<p>This is optional if using Claude Code, which runs via <code>npx</code> by default.</p>
38+
<p>Optional for agent users (faster than <code>npx</code>). Required for CLI-only usage.</p>
2939

3040
<h2>Shell Completions</h2>
3141
<p>Enable tab completion for dex commands and task IDs.</p>

0 commit comments

Comments
 (0)