Skip to content

Commit 6208e49

Browse files
committed
docs(prompts): replace flat ref list with sphinx-design grid
Swap the four-item bulleted list of `{ref}` links at the top of /prompts/ for a responsive sphinx-design grid with code-styled titles, one-line use-case summaries, and whole-card click targets (sd-stretched-link) that scroll smoothly to the same-page anchors. Also drop the hardcoded 'Four prompts ship today:' lead-in — the count rots the moment a fifth prompt ships — and replace it with an '## Available prompts' section heading so the list now has a TOC anchor on the right sidebar.
1 parent e563112 commit 6208e49

1 file changed

Lines changed: 30 additions & 10 deletions

File tree

docs/prompts.md

Lines changed: 30 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,16 +8,36 @@ ships to its clients. A client renders a prompt by calling
88
libtmux-mcp's prompts are short *workflow recipes* — the MCP-shaped
99
counterpart to the longer narrative recipes in {doc}`/recipes`.
1010

11-
Four prompts ship today:
12-
13-
- {ref}`fastmcp-prompt-run-and-wait` — execute a shell command and block until it
14-
finishes, preserving exit status.
15-
- {ref}`fastmcp-prompt-diagnose-failing-pane` — gather pane context and produce a
16-
root-cause hypothesis without taking action.
17-
- {ref}`fastmcp-prompt-build-dev-workspace` — set up a 3-pane editor / shell / logs
18-
layout shell-agnostically.
19-
- {ref}`fastmcp-prompt-interrupt-gracefully` — send SIGINT and verify the shell
20-
prompt returns, refusing to auto-escalate.
11+
## Available prompts
12+
13+
::::{grid} 1 2 2 2
14+
:gutter: 2 2 3 3
15+
16+
:::{grid-item-card} `run_and_wait`
17+
:link: fastmcp-prompt-run-and-wait
18+
:link-type: ref
19+
Execute a shell command and block until it finishes, preserving exit status.
20+
:::
21+
22+
:::{grid-item-card} `diagnose_failing_pane`
23+
:link: fastmcp-prompt-diagnose-failing-pane
24+
:link-type: ref
25+
Gather pane context and produce a root-cause hypothesis without taking action.
26+
:::
27+
28+
:::{grid-item-card} `build_dev_workspace`
29+
:link: fastmcp-prompt-build-dev-workspace
30+
:link-type: ref
31+
Set up a 3-pane editor / shell / logs layout shell-agnostically.
32+
:::
33+
34+
:::{grid-item-card} `interrupt_gracefully`
35+
:link: fastmcp-prompt-interrupt-gracefully
36+
:link-type: ref
37+
Send SIGINT and verify the shell prompt returns, refusing to auto-escalate.
38+
:::
39+
40+
::::
2141

2242
```{tip}
2343
Most MCP clients render prompts via a slash-command UI

0 commit comments

Comments
 (0)