quarto-survey-analysis

agent-plugins

Claude Code用のカスタムスキル・プラグインを集積したマーケットプレイスです。

インストール

1. マーケットプレイスの追加

Claude Codeで以下のコマンドを実行：

/plugin marketplace add ncukondo/agent-plugins

2. プラグインのインストール

利用したいプラグインをインストール：

/plugin add <プラグイン名>@agent-plugins

例：

/plugin add thematic-analysis@agent-plugins

3. インストール済みプラグインの確認

/plugin list

利用可能なプラグイン

プラグイン名	説明
thematic-analysis	質的研究のテーマ分析スキル
quarto-survey-analysis	CSVアンケートからQuartoレポート・スライド生成

---

プラグイン詳細

thematic-analysis

テキストファイル群から質的研究のテーマ分析（Thematic Analysis）を実行するスキル。

機能

• ファイル名へのインデックス自動付与
• 文単位でのCSV出力
• テーマの抽出・命名
• 深層構造分析（テーマ間の関係性、背景メカニズム等）

使い方

/thematic-analysis

または、対象ディレクトリで「テーマ分析して」「質的分析」などと依頼すると自動的に起動します。

対象ファイル

• .txt, .md, .docx ファイル
• context.md - 分析の文脈情報（任意）

出力ファイル

• sentences.csv - 全文のインデックス付きデータ
• themes.md - テーマ分析結果

---

quarto-survey-analysis

CSVアンケートデータから Quarto + Python パイプラインで統計集計・可視化・PDFレポート・PPTXスライドを生成するプラグイン。2つのスキルで構成される。

インストール

/plugin add quarto-survey-analysis@agent-plugins

スキル一覧

スキル	説明
quarto-survey-setup	プロジェクト環境構築（uv + Quarto + Typst PDF パイプライン）
survey-report-builder	アンケート分析レポート構築（集計・可視化・PDF・PPTX）

基本的な使い方

Step 1: プロジェクト作成

/quarto-survey-setup my-survey-project

以下が自動生成される:

• pyproject.toml（pandas, matplotlib, python-pptx 等）
• _quarto.yml（Typst PDF, 日本語設定, A4）
• .gitignore, .python-version, CLAUDE.md
• WSL環境では .mise.toml（venvをユーザーディレクトリに配置）

Step 2: データ配置

data/ ディレクトリに CSV ファイルを配置する。

Step 3: レポート構築

/survey-report-builder data/survey.csv

以下が対話的に構築される:

• data/exam_metadata.json（ラベルマッピング、メタデータ）
• index.qmd（分析コード全体）
• output/ 配下に CSV集計・SVG図・PDFレポート

出力ファイル

ファイル	内容
output/index.pdf	Typst PDFレポート
output/summary_*.csv	各設問の度数分布表
output/figures/*.svg	横棒グラフ・積み上げ棒グラフ
output/tables/*.svg	テーブルSVG
output/*.pptx	テーマ別スライド（質的分析時）

コマンド

uv run render    # PDFレポート生成
uv run preview   # ライブプレビュー（port 4200）
uv run slides    # PPTXスライド生成（質的分析時）

技術スタック

• Python 3.13, pandas, matplotlib, matplotlib-fontja, python-pptx
• Quarto → Typst PDF（日本語対応, Yu Gothic, A4）
• UV + mise（WSL環境対応）

---

新しいプラグインの追加方法

ディレクトリ構造

agent-plugins/
├── .claude-plugin/
│   └── marketplace.json       # マーケットプレイスカタログ
└── plugins/
    └── <プラグイン名>/
        ├── .claude-plugin/
        │   └── plugin.json    # プラグインメタデータ
        └── skills/
            └── <スキル名>/
                ├── SKILL.md   # スキル定義
                └── scripts/   # 補助スクリプト（任意）

手順

1. プラグインディレクトリを作成

mkdir -p plugins/<プラグイン名>/.claude-plugin
mkdir -p plugins/<プラグイン名>/skills/<スキル名>

2. plugin.json を作成

{
  "name": "<プラグイン名>",
  "description": "プラグインの説明",
  "version": "1.0.0",
  "author": {
    "name": "作成者名"
  }
}

3. SKILL.md を作成

---
name: <スキル名>
description: スキルの説明（Claudeが自動判断に使用）
---

# スキル名

スキルの詳細な説明と実行手順...

4. marketplace.json に追加

.claude-plugin/marketplace.json の plugins 配列に追加：

{
  "plugins": [
    {
      "name": "<プラグイン名>",
      "source": "./plugins/<プラグイン名>",
      "description": "プラグインの説明"
    }
  ]
}

SKILL.md の書き方

基本構造

---
name: skill-name
description: スキルの説明（自動実行の判断に使用される）
---

# スキル名

## 概要
何をするスキルか

## 使い方
具体的な手順

## 入出力
入力ファイル、出力ファイルの説明

オプション設定

フィールド	説明	例
disable-model-invocation	trueで手動呼び出しのみ	デプロイなど副作用のある操作
user-invocable	falseでユーザーから非表示	背景知識のみのスキル
allowed-tools	使用可能なツールを制限	Read, Grep, Bash(python:*)
context	forkで独立エージェントで実行	大量ファイル処理

スクリプトの参照

プラグイン内のスクリプトは $SKILL_ROOT 変数を使用：

```bash
python "$SKILL_ROOT/scripts/my_script.py" [引数]

---

## アンインストール

### プラグインの削除

/plugin remove thematic-analysis@agent-plugins

### マーケットプレイスの削除

/plugin marketplace remove agent-plugins

---

## ライセンス

MIT License