Claude Code Plugins

Community-maintained marketplace

Feedback

.claude/skills/tutorial-design/SKILL.md

@mattnigh/skills_collection
0
0

|

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name .claude/skills/tutorial-design/SKILL.md
description 効果的な学習体験を提供するチュートリアル設計スキル。 📚 リソース参照: このスキルには以下のリソースが含まれています。 必要に応じて該当するリソースを参照してください: - `.claude/skills/tutorial-design/resources/learning-path-design.md`: Learning Path Designリソース - `.claude/skills/tutorial-design/templates/tutorial-template.md`: Tutorialテンプレート - `.claude/skills/tutorial-design/scripts/estimate-completion-time.mjs`: Estimate Completion Timeスクリプト
version 1.0.0

Tutorial Design スキル

概要

このスキルは、ユーザーが実践を通じて学べる効果的なチュートリアルの 設計・作成技術を提供します。段階的学習、成功体験の設計、 視覚補助の活用を通じて、ユーザーのスキル習得を支援します。

段階的学習パス設計

3 レベル学習パスモデル

Level 1: クイックスタート (5-10分)
├── 目的: 最初の成功体験を提供
├── 内容: 最小限の操作で達成可能なタスク
├── 成果: モチベーション構築
└── 例: 「5分で最初のワークフローを実行」

Level 2: 基本チュートリアル (20-30分)
├── 目的: 主要機能の体系的学習
├── 内容: コア機能の習得
├── 成果: 実用的なタスクの達成
└── 例: 「基本的なレポートを作成する」

Level 3: 応用チュートリアル (60分+)
├── 目的: 複雑なワークフローの習得
├── 内容: 高度な機能と組み合わせ
├── 成果: ベストプラクティスの理解
└── 例: 「カスタムダッシュボードを構築する」

レベル別設計原則

レベル 前提知識 詳細度 視覚補助 成功基準
Level 1 なし 最小限 必須 5 分以内で完了
Level 2 Level 1 完了 中程度 推奨 主要タスク達成
Level 3 Level 2 完了 詳細 任意 応用能力獲得

ステップバイステップ構造

ステップ設計原則

  1. 1 ステップ 1 アクション: 各ステップは単一の明確なアクションのみ
  2. 番号付き: すべてのステップに番号を付与
  3. 動詞で開始: 「クリックします」「入力します」「選択します」
  4. 視覚的確認: 各ステップの成功を確認できる方法を提示

ステップ構造テンプレート

### ステップ N: [アクションの目的]

[アクションの説明]

1. **[具体的なアクション]**
   - 操作: [クリック/入力/選択]
   - 場所: [UI 要素の特定]
   - 値: [入力する値（該当する場合）]

2. **[次のアクション]**
   ...

💡 **ヒント**: [補足情報]

✅ **確認ポイント**: [成功時に表示される内容]

⚠️ **注意**: [よくある間違いや注意点]

補助要素の配置

要素 アイコン 使用場面
ヒント 💡 追加の便利情報
確認ポイント ✅ 成功の確認方法
警告 ⚠️ 注意すべき点
重要 🔴 必須の注意事項
参照 📚 関連情報へのリンク

前提条件セクション設計

必須要素

## はじめる前に

### 必要なもの

- [ ] [必要なアカウント/権限]
- [ ] [必要なソフトウェア/ツール]
- [ ] [必要なデータ/ファイル]

### 前提知識

- [理解しておくべき概念]
- [完了しておくべきチュートリアル]

### 所要時間

- 約 [X] 分

### 対象者

- [どのようなユーザー向けか]

視覚補助の活用

スクリーンショット設計

配置原則

  1. ステップ直後配置: アクション説明の直後に配置
  2. 最新状態維持: 現在の UI と一致
  3. 強調表示: 操作箇所を矢印やハイライトで強調
  4. キャプション付き: 何を示しているか説明

アノテーション規約

要素 色 用途
矢印 赤 クリック位置の指示
枠線 青 注目エリアの強調
番号 緑 手順の順序
テキスト 黒 補足説明

図解の種類と使い分け

種類 使用場面 作成ツール
フローチャート プロセスの全体像 Mermaid
画面遷移図 UI 操作の流れ Figma/Draw.io
概念図 関係性の説明 Mermaid
比較表 選択肢の整理 Markdown 表

期待結果の記述

成功基準の明示

## 完了後の状態

このチュートリアルを完了すると:

✅ [達成されること 1]
✅ [達成されること 2]
✅ [達成されること 3]

### 確認方法

[成功を確認する具体的な手順]

### 次のステップ

- [次に学ぶべきチュートリアル]
- [関連する高度なトピック]

トラブルシューティングリンク

エラー誘導パターン

## うまくいかない場合

### よくある問題

<details>
<summary>❓ [問題の症状]</summary>

**原因**: [問題の原因]

**解決方法**:

1. [解決手順 1]
2. [解決手順 2]

</details>

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

- [トラブルシューティングガイドへのリンク]
- [サポートへの問い合わせ方法]

チュートリアル完成度チェックリスト

構造チェック

  • 前提条件が明示されているか？
  • 所要時間が記載されているか？
  • 対象者が明確か？
  • すべてのステップに番号があるか？
  • 各ステップは 1 アクションか？

内容チェック

  • ステップの説明は具体的か？
  • 視覚的補助（スクリーンショット等）があるか？
  • 確認ポイントが各ステップにあるか？
  • 期待結果が明示されているか？

ユーザビリティチェック

  • 初心者が理解できる言葉か？
  • 専門用語は説明されているか？
  • エラー時の誘導があるか？
  • 次のステップへの案内があるか？

リソース参照

リソース パス 内容
完了時間見積もり .claude/skills/tutorial-design/scripts/estimate-completion-time.mjs ステップ数から所要時間を算出
チュートリアルテンプレート .claude/skills/tutorial-design/templates/tutorial-template.md 標準チュートリアル構造
学習パス設計ガイド .claude/skills/tutorial-design/resources/learning-path-design.md 段階的学習の詳細設計

関連スキル

  • .claude/skills/user-centric-writing/SKILL.md: ユーザー中心ライティング
  • .claude/skills/troubleshooting-guides/SKILL.md: トラブルシューティング設計
  • .claude/skills/information-architecture/SKILL.md: ドキュメント構造設計