diff --git a/packages/spindle-icons/README.md b/packages/spindle-icons/README.md
index 726af377e..b7a54f4f6 100644
--- a/packages/spindle-icons/README.md
+++ b/packages/spindle-icons/README.md
@@ -1,25 +1,48 @@
# Spindle Icons (In development)
-- [アイコンリスト](icons.md)
-- [Design Doc](design-doc.md)
+SVG and PDF Icons with Spindle (Ameba Design System)
+
+> Spindle Iconsは試験開発中のため、大幅に変更される可能性があります。安定版リリースまでの間はバージョン番号は0となり、バージョンに関わらずbreaking changeが行われることがありますので、利用時には注意してください。変更内容は、[CHANGELOG](CHANGELOG.md)に記載されています。
+
+ 
+
+## インストール
+```
+npm install @openameba/spindle-icons
+```
+
+```
+yarn add @openameba/spindle-icons
+```
## 利用方法
-Spindle Iconsで生成されたSVGアイコンは、以下の方法で利用できます。
+Spindle Iconsで生成されたSVGアイコンは、以下の方法で利用できます。利用できるアイコンは[アイコンリスト](docs/icons.md)を参照してください。
### img要素
最も簡単な利用方法は、img要素としてSVGファイルを読み込むことです。いくつかのスクリーンリーダーでは、SVG読み込みするimg要素の`alt`属性のテキストを省略するため、`role="img"`を付与します。
-ただし、この方法ではアイコンの表示色を指定できないため、多くの要件を満たせないでしょう。
+ただし、この方法ではアイコンの表示色を指定できないため、要件を満たせない場合があります。
```html
```
## Inline SVG
-SVGをHTMLに埋め込みます。アイコンは様々なコンテキストで利用される可能性があるため、Spindle Iconsで生成するSVG自体にタイトルは設定されていません。利用時には、都度テキストを挿入する必要があります。
+SVGをHTMLに埋め込みます。
+
+SVGを埋め込むには、HTMLファイルにSVG文字列をそのまま埋め込むか、テンプレートエンジンやバンドラなどでビルドします。
+
+```pug
+//- Pugの例
+
+button(aria-label="時間設定")
+ include 'node_modules/@opanameba/spindle-icons/dist/svg/clock.svg'
+```
+
+アイコンは様々なコンテキストで利用される可能性があるため、Spindle Iconsで生成するSVG自体にタイトルは設定されていません。利用時には、都度テキストを挿入する必要があります。
一つの方法として、テキストをspan要素などを使って、非表示のテキストとして指定します。
@@ -60,9 +83,29 @@ SVGを装飾として利用する場合には、テキストと同時に利用
### SVG Sprite
-アプリケーションでは、一般的に複数のアイコンが利用されるため、SVG Spriteも有効な手段です。
+アプリケーションでは、一般的に複数のアイコンが利用されるため、SVG Spriteも有効な手段です。Spindle Iconsではすべてのアイコンで作られた[sprite.svg](dist/svg/sprite.svg)を配布しています。ただしファイル容量も大きいので、[svg-sprite](https://github.com/jkphl/svg-sprite)などを利用して、必要なアイコンのみでSVG Spriteを生成することを推奨します。
+
+```sh
+# 必要なアイコンのみでSVG Spriteを生成する例
+# 各オプションはそれぞれのプロジェクトに合わせて設定します
+
+npx svg-sprite --symbol --symbol-dest=. --symbol-sprite=sprite.svg --shape-transform-svgo sprite.svgo.json --dest=＄PATH_TO_SVG 'node_modules/@openameba/spindle-icons/dist/+(check|exclamationmark).svg'
+
+# sprite.svgo.jsonの例
+# SVG各ファイルに付与されている無駄なfillを消したい場合に設定します
+{
+ "plugins": [
+ {
+ "removeAttrs":
+ {
+ "attrs": "fill"
+ }
+ }
+ ]
+}
+```
-テキストはsvg要素内の`title`属性で指定し、svg要素の`aria-labelledby`属性から参照します。Inline SVGと同様に、`.visually-hidden`要素や `aria-label`でテキストを指定します。装飾用途ではタイトルを省略できます。
+アイコンを利用する際には、ラベリングを忘れないようにしてください。テキストはsvg要素内の`title`属性で指定し、svg要素の`aria-labelledby`属性から参照します。Inline SVGと同様に、`.visually-hidden`要素や `aria-label`でテキストを指定します。装飾用途ではタイトルを省略できます。
```html