From 3a6038c12bf3f3aa2bbe4ef152ad3a360fc16bd7 Mon Sep 17 00:00:00 2001
From: konojunya <junya03dance@gmail.com>
Date: Sun, 6 Sep 2026 06:16:29 +0900
Subject: [PATCH] docs: connect installation to the first SVG walkthrough

---
 README.md               | 15 +++++++++++++++
 skills/docs-source.json |  4 ++--
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 4ccd1ef..d23cce7 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,21 @@ stack --version
 
 For a direct installation, download the archive for your target and its verification material from [GitHub Releases](https://github.com/stack-sh/cli/releases/tag/v0.5.1). Verify the checksum signature and both attestations by following the [supply-chain guide](./docs/supply-chain.md), then follow the [direct installation steps](./docs/distribution.md#direct-installation). The macOS artifacts are reproducibly ad-hoc signed, not Apple-notarized; Sigstore and GitHub attestations provide the publisher-identity check.
 
+## Create your first SVG
+
+After installing, open a new empty working directory and run:
+
+```sh
+stack --version
+stack init
+stack check diagram.stack
+stack render diagram.stack -o diagram.svg
+```
+
+Expect `stack 0.5.1`, a new `diagram.stack`, no check errors, and a non-empty `diagram.svg`. Open the SVG in a browser or include it in your README. Edit the source and repeat check/render; `stack init` refuses to overwrite existing work.
+
+The [four-language getting-started guide](https://stack-diagram.com/docs/guide/getting-started) keeps every installer, this walkthrough, and upgrade/uninstall guidance together. It is maintained in `stack-sh/docs` and verified against the published binary.
+
 ## Commands
 
 The command inventory below is available in the published 0.5.1 binaries, including `stack doctor`, `stack config`, and structured JSON output for automation.
diff --git a/skills/docs-source.json b/skills/docs-source.json
index 9da4786..ce5329e 100644
--- a/skills/docs-source.json
+++ b/skills/docs-source.json
@@ -1,5 +1,5 @@
 {
   "repository": "stack-sh/docs",
-  "revision": "5eed6efed732323008a65274919e107aac8512c0",
-  "manifestSha256": "a4c33a2ba7bf34af49f6bd80844b009ffba2a2652c658778d2fb423c0a313097"
+  "revision": "470ec245a4c491ec0e27b717eaea6fab6ade22fd",
+  "manifestSha256": "856d190ced590cffe4613c4f34276de3cbf3e9f8059b5c323d4247f03bd12bb6"
 }