jpskill.com
✍️ ライティング コミュニティ

user-guide-writing

エンドユーザーが製品やサービスをスムーズに使いこなせるよう、オンボーディング資料、操作ガイド、FAQページなど、スクリーンショットや手順を含んだ分かりやすいユーザー向けガイドやチュートリアルを作成するSkill。

📜 元の英語説明(参考)

Write clear and helpful user guides and tutorials for end users. Use when creating onboarding docs, how-to guides, or FAQ pages. Handles user-focused documentation, screenshots, step-by-step instructions.

🇯🇵 日本人クリエイター向け解説

一言でいうと

エンドユーザーが製品やサービスをスムーズに使いこなせるよう、オンボーディング資料、操作ガイド、FAQページなど、スクリーンショットや手順を含んだ分かりやすいユーザー向けガイドやチュートリアルを作成するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o user-guide-writing.zip https://jpskill.com/download/20932.zip && unzip -o user-guide-writing.zip && rm user-guide-writing.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/20932.zip -OutFile "$d\user-guide-writing.zip"; Expand-Archive "$d\user-guide-writing.zip" -DestinationPath $d -Force; ri "$d\user-guide-writing.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して user-guide-writing.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → user-guide-writing フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

ユーザーガイドの作成

このスキルを使用する場面

  • 新機能: ユーザーに新機能を紹介する
  • オンボーディング: 新規ユーザーをトレーニングする
  • FAQ: よくある質問を整理する

手順

ステップ 1: クイックスタートガイド

# MyApp を始める

MyApp へようこそ!このガイドは、5分でMyAppを使い始めるのに役立ちます。

## ステップ 1: アカウントを作成する

1. [https://myapp.com/signup](https://myapp.com/signup) にアクセスします
2. メールアドレスを入力し、パスワードを作成します
   - パスワードは8文字以上である必要があります
   - 大文字、小文字、数字を含める必要があります
3. 「Sign Up」をクリックします
4. 確認リンクが記載されたメールを確認します
5. リンクをクリックしてアカウントを認証します

![Sign Up Form](images/signup.png)

## ステップ 2: プロフィールを完成させる

1. 右上隅のアバターをクリックします
2. 「Profile Settings」を選択します
3. 名前とプロフィール写真を追加します
4. 「Save Changes」をクリックします

## ステップ 3: 最初のプロジェクトを作成する

1. 「+ New Project」ボタンをクリックします
2. プロジェクト名を入力します
3. テンプレートを選択します(または最初から作成します)
4. 「Create」をクリックします

🎉 おめでとうございます!MyApp を使い始める準備ができました。

## 次のステップ

- [ビデオチュートリアルを見る](https://youtube.com/watch?v=xxx)
- [機能を探索する](docs/features.md)
- [コミュニティに参加する](https://community.myapp.com)

## ヘルプが必要ですか?

- 📧 メール: support@myapp.com
- 💬 ライブチャット: 午前9時~午後5時(米国東部時間)
- 📚 [ヘルプセンター](https://help.myapp.com)

ステップ 2: ハウツーガイド(タスク中心)

# データをエクスポートする方法

このガイドでは、MyApp からすべてのデータをエクスポートする方法を説明します。

## 開始する前に

- データのエクスポートには、サイズに応じて5~10分かかる場合があります
- エクスポートの準備ができたときにメールが届きます
- エクスポートされたデータはJSON形式です

## ステップバイステップの手順

### 1. 設定に移動する

右上隅のプロフィール写真をクリックし、「**Settings**」を選択します。

![Settings Menu](images/settings-menu.png)

### 2. データエクスポートに移動する

左側のサイドバーで、「**Privacy & Data**」をクリックします。

次に、「**Export Data**」セクションまでスクロールします。

![Privacy & Data Page](images/privacy-data.png)

### 3. エクスポートをリクエストする

「**Request Export**」ボタンをクリックします。

確認ダイアログが表示されます。

> **データをエクスポートする**
>
> エクスポートの準備ができたときに、ダウンロードリンクが記載されたメールをお送りします。
> 通常、これには5~10分かかります。
>
> [キャンセル] [確認]

「**Confirm**」をクリックして続行します。

### 4. メールを確認する

登録済みのメールアドレスに、件名「**"Your Data Export is Ready"**」のメールが届きます。

メールには、7日間有効な安全なダウンロードリンクが含まれています。

### 5. データをダウンロードする

メールのダウンロードリンクをクリックします。

以下の内容を含むZIPファイルがダウンロードされます。
- `profile.json` - プロフィール情報
- `projects.json` - すべてのプロジェクト
- `files/` - アップロードされたファイル

## トラブルシューティング

**問題**: メールが届かない
- スパムフォルダを確認してください
- 設定でメールアドレスが正しいことを確認してください
- もう一度リクエストしてみてください(1日1回リクエストできます)

**問題**: ダウンロードリンクの有効期限が切れている
- 設定から新しいエクスポートをリクエストしてください

**問題**: エクスポートファイルが破損している
- もう一度ダウンロードしてみてください
- 問題が解決しない場合は、support@myapp.com にお問い合わせください

## 関連ガイド

- [アカウントを削除する方法](delete-account.md)
- [プライバシーポリシー](privacy-policy.md)
- [データセキュリティ](data-security.md)

ステップ 3: FAQ(よくある質問)

# よくある質問 (FAQ)

## アカウントと請求

### メールアドレスを変更するにはどうすればよいですか?

1. **Settings** > **Account** に移動します
2. **Change Email** をクリックします
3. 新しいメールアドレスとパスワードを入力します
4. **Update** をクリックします
5. 新しいメールアドレスを認証します

### MyApp を無料で利用できますか?

はい、できます!MyApp には無料プランがあり、以下が含まれます。
- 最大3つのプロジェクト
- 1 GBのストレージ
- 基本機能

[プランを比較する](https://myapp.com/pricing)

### サブスクリプションをキャンセルするにはどうすればよいですか?

1. **Settings** > **Billing** に移動します
2. **Cancel Subscription** をクリックします
3. プロンプトに従います

サブスクリプションは、請求期間の終わりまで有効です。

## 機能

### チームメンバーと共同作業するにはどうすればよいですか?

1. プロジェクトを開きます
2. **Share** ボタンをクリックします
3. チームメンバーのメールアドレスを入力します
4. 権限レベル(View、Edit、Admin)を選択します
5. **Send Invite** をクリックします

チームメンバーにはメールで招待が届きます。

### プロジェクトをエクスポートできますか?

はい、[エクスポートガイド](export-data.md)をご覧ください。

### どのようなファイル形式がサポートされていますか?

- 画像: JPG, PNG, GIF, SVG
- ドキュメント: PDF, DOCX, TXT, MD
- コード: すべてのテキストファイル

## 技術

### データは安全ですか?

はい、安全です!当社は以下を使用しています。
- 256ビットSSL暗号化
- 定期的なセキュリティ監査
- SOC 2 Type II認定
- GDPR準拠

[セキュリティページを読む](security.md)

### MyApp をオフラインで使用できますか?

現在、MyApp はインターネット接続が必要です。オフラインモードは2025年第2四半期に予定されています。

### ブラウザの互換性?

MyApp は以下のブラウザで最適に動作します。
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

## まだ質問がありますか?

- 📧 メール: support@myapp.com
- 💬 ライブチャット(午前9時~午後5時 米国東部時間)
- 🎓 [ビデオチュートリアル](tutorials.md)
- 👥 [コミュニティフォーラム](https://community.myapp.com)

ステップ 4: チュートリアル(学習中心)

# チュートリアル: 最初のダッシュボードを構築する

このチュートリアルでは、チャートとウィジェットを使って美しいダッシュボードを作成する方法を学びます。

**所要時間**: 15分
**難易度**: 初級
**前提条件**: MyApp アカウント

## 作成するもの

![Final Dashboard](images/tutorial-dashboard.png)

## ステップ 1: 新しいダッシュボードを作成する

**+ New Dashboard** をクリックし、「Sales Dashboard」という名前を付けます。

## ステップ 2: チャートウィジェットを追加する

1. **Add Widget** → **Chart** をクリックします
2. **Bar Chart** を選択します
3. データソースを設定します。
   - データ: Monthly Sales
   - X軸: Month
   - Y軸: Revenue
4. **Add to Dashboard** をクリックします

![Adding Chart Widget](images/add-chart.gif)

## ステップ 3: 統計ウィジェットを追加する

1. **Add Widget** → **Stat Card** をクリックします
2. メトリックを選択します: Total Revenue
3. 比較を設定します: vs. Last Month
4. **Add to Dashboard** をクリックします

## ステップ 4: ウィジェットを配置する

ウィジェットをドラッグアンドドロップして配置します。

**プロのヒント**: サイズ変更時に Shift キーを押すと、正確な制御が可能です。

## ステップ 5: 保存する

(原文がここで切り詰められています)
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

User Guide Writing

When to use this skill

  • New Features: Introduce new features to users
  • Onboarding: Train new users
  • FAQ: Organize frequently asked questions

Instructions

Step 1: Quick Start Guide

# Getting Started with MyApp

Welcome to MyApp! This guide will help you get up and running in 5 minutes.

## Step 1: Create an Account

1. Go to [https://myapp.com/signup](https://myapp.com/signup)
2. Enter your email and create a password
   - Password must be at least 8 characters
   - Include uppercase, lowercase, and numbers
3. Click "Sign Up"
4. Check your email for verification link
5. Click the link to verify your account

![Sign Up Form](images/signup.png)

## Step 2: Complete Your Profile

1. Click on your avatar in the top-right corner
2. Select "Profile Settings"
3. Add your name and profile picture
4. Click "Save Changes"

## Step 3: Create Your First Project

1. Click the "+ New Project" button
2. Enter a project name
3. Choose a template (or start from scratch)
4. Click "Create"

🎉 Congratulations! You're ready to start using MyApp.

## Next Steps

- [Watch the video tutorial](https://youtube.com/watch?v=xxx)
- [Explore features](docs/features.md)
- [Join our community](https://community.myapp.com)

## Need Help?

- 📧 Email: support@myapp.com
- 💬 Live chat: Available 9 AM - 5 PM EST
- 📚 [Help Center](https://help.myapp.com)

Step 2: How-To Guide (Task-Focused)

# How to Export Your Data

This guide shows you how to export all your data from MyApp.

## Before You Start

- Exporting data may take 5-10 minutes depending on size
- You'll receive an email when the export is ready
- Exported data is in JSON format

## Step-by-Step Instructions

### 1. Navigate to Settings

Click on your profile picture in the top-right corner and select **Settings**.

![Settings Menu](images/settings-menu.png)

### 2. Go to Data Export

In the left sidebar, click on **Privacy & Data**.

Then scroll down to the **Export Data** section.

![Privacy & Data Page](images/privacy-data.png)

### 3. Request Export

Click the **Request Export** button.

A confirmation dialog will appear:

> **Export Your Data**
>
> We'll send you an email with a download link when your export is ready.
> This usually takes 5-10 minutes.
>
> [Cancel] [Confirm]

Click **Confirm** to proceed.

### 4. Check Your Email

You'll receive an email at your registered address with subject:
**"Your Data Export is Ready"**

The email contains a secure download link that expires in 7 days.

### 5. Download Your Data

Click the download link in the email.

A ZIP file will be downloaded containing:
- `profile.json` - Your profile information
- `projects.json` - All your projects
- `files/` - Uploaded files

## Troubleshooting

**Problem**: I didn't receive the email
- Check your spam folder
- Make sure your email is correct in Settings
- Try requesting again (you can request once per day)

**Problem**: Download link expired
- Request a new export from Settings

**Problem**: Export file is corrupted
- Try downloading again
- If issue persists, contact support@myapp.com

## Related Guides

- [How to Delete Your Account](delete-account.md)
- [Privacy Policy](privacy-policy.md)
- [Data Security](data-security.md)

Step 3: FAQ (Frequently Asked Questions)

# Frequently Asked Questions (FAQ)

## Account & Billing

### How do I change my email address?

1. Go to **Settings** > **Account**
2. Click **Change Email**
3. Enter your new email and password
4. Click **Update**
5. Verify your new email

### Can I use MyApp for free?

Yes! MyApp has a free tier that includes:
- Up to 3 projects
- 1 GB storage
- Basic features

[Compare plans](https://myapp.com/pricing)

### How do I cancel my subscription?

1. Go to **Settings** > **Billing**
2. Click **Cancel Subscription**
3. Follow the prompts

Your subscription will remain active until the end of the billing period.

## Features

### How do I collaborate with team members?

1. Open your project
2. Click the **Share** button
3. Enter team member's email
4. Choose their permission level (View, Edit, Admin)
5. Click **Send Invite**

They'll receive an email invitation.

### Can I export my projects?

Yes, see our [Export Guide](export-data.md).

### What file formats are supported?

- Images: JPG, PNG, GIF, SVG
- Documents: PDF, DOCX, TXT, MD
- Code: All text files

## Technical

### Is my data secure?

Yes! We use:
- 256-bit SSL encryption
- Regular security audits
- SOC 2 Type II certified
- GDPR compliant

[Read our Security Page](security.md)

### Can I use MyApp offline?

Currently, MyApp requires an internet connection. Offline mode is planned for Q2 2025.

### Browser compatibility?

MyApp works best on:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

## Still Have Questions?

- 📧 Email: support@myapp.com
- 💬 Live Chat (9 AM - 5 PM EST)
- 🎓 [Video Tutorials](tutorials.md)
- 👥 [Community Forum](https://community.myapp.com)

Step 4: Tutorial (Learning-Focused)

# Tutorial: Build Your First Dashboard

In this tutorial, you'll learn how to create a beautiful dashboard with charts and widgets.

**Time**: 15 minutes
**Difficulty**: Beginner
**Prerequisites**: MyApp account

## What You'll Build

![Final Dashboard](images/tutorial-dashboard.png)

## Step 1: Create a New Dashboard

Click **+ New Dashboard** and name it "Sales Dashboard".

## Step 2: Add a Chart Widget

1. Click **Add Widget** → **Chart**
2. Select **Bar Chart**
3. Configure data source:
   - Data: Monthly Sales
   - X-axis: Month
   - Y-axis: Revenue
4. Click **Add to Dashboard**

![Adding Chart Widget](images/add-chart.gif)

## Step 3: Add a Stats Widget

1. Click **Add Widget** → **Stat Card**
2. Choose metric: Total Revenue
3. Set comparison: vs. Last Month
4. Click **Add to Dashboard**

## Step 4: Arrange Widgets

Drag and drop widgets to arrange them.

**Pro Tip**: Hold Shift while resizing for precise control.

## Step 5: Save and Share

1. Click **Save Dashboard**
2. Click **Share** to invite team members

## Next Steps

Now that you've created your first dashboard, try:

- [Adding filters](filters.md)
- [Scheduling reports](reports.md)
- [Customizing themes](themes.md)

## Congratulations!

You've completed the tutorial. Happy dashboard building! 🎉

Output format

docs/
├── getting-started.md      # Quick start
├── how-to/
│   ├── export-data.md
│   ├── invite-team.md
│   └── create-project.md
├── tutorials/
│   ├── first-dashboard.md
│   └── advanced-features.md
├── faq.md
└── images/
    ├── signup.png
    └── dashboard.png

Constraints

Required Rules (MUST)

  1. Include Screenshots: Visual guides
  2. Step-by-Step Instructions: 1, 2, 3 format
  3. User Language: Avoid technical jargon

Forbidden (MUST NOT)

  1. Technical Jargon Overload: API, endpoint, etc.
  2. Long Paragraphs: Keep short and clear

Best practices

  1. User-Centric: Write from the user's perspective
  2. Show, Don't Tell: Screenshots, GIFs, videos
  3. Update Regularly: Update docs when UI changes

References

Metadata

Version

  • Current Version: 1.0.0
  • Last Updated: 2025-01-01
  • Compatible Platforms: Claude, ChatGPT, Gemini

Tags

#user-guides #tutorials #documentation #onboarding #how-to #FAQ

Examples

Example 1: Basic usage

<!-- Add example content here -->

Example 2: Advanced usage

<!-- Add advanced example content here -->