Gist-Writer の設定

データルートを解決します：

DATA_ROOT="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/gist-writer"
mkdir -p "$DATA_ROOT"

設定は $DATA_ROOT/config.json に保存されます。既存の値がある場合は読み込み、デフォルト値として提示します。

キャプチャする設定項目

{
  "default_visibility": "public",
  "github_user": "<auto-detected from `gh api user --jq .login`>",
  "include_environment_block": true,
  "model_attribution": "auto"
}

default_visibility

public または private です。プロンプトの配布デフォルト: public（ユーザーがパブリック優先にオプトインしました）。ユーザーが設定を完全にスキップし、スキルが値を必要とする場合は、private にフォールバックします（安全なデフォルト — 明示的なオプトインなしで公開しないように）。

github_user

テンプレートフッターに表示されるハンドル（Posted by [@user]）。gh api user --jq .login で自動検出します。ユーザーは上書きできます。

include_environment_block

debug-writeup-gist の場合、ホストから環境セクションを自動入力するかどうかを指定します（OS、カーネル、デスクトップセッション、関連するパッケージバージョン）。デフォルト: true。

model_attribution

AI 作成バナーにモデル名がどのように表示されるかを指定します。

• auto（デフォルト）— $CLAUDE_MODEL が設定されている場合はそこから読み込み、そうでない場合は公開時にユーザーが確認するためのプレースホルダーを残します。
• リテラル文字列（例: "Claude Sonnet 4.6"）— この文字列をそのまま使用します。

ワークフロー

1. 既存の config.json がある場合は読み込みます。
2. 各設定について、現在の値/提案されたデフォルトを表示します。Enter を押して保持できます。
3. 検証: default_visibility ∈ {public, private}、github_user が空でない、ブール値は実際にブール値である。
4. chmod 600 でファイルを書き込みます（シークレットではありませんが、ユーザースコープです）。
5. パスを確認します: 「$DATA_ROOT/config.json に書き込みました。」

GITHUB_TOKEN — .env を書き込む

バンドルされた github-gist MCP は GITHUB_TOKEN（gist スコープ付き PAT）が必要です。ユーザーに shell rc エクスポートを管理させるのではなく、プラグインごとの .env に書き込みます：

1. トークンのプロンプトを表示します（1Password が利用可能な場合は op:// リファレンスを受け入れます）。

2. $DATA_ROOT/.env に書き込みます：

   GITHUB_TOKEN=<your-github-pat-with-gist-scope>
   

3. chmod 600 "$DATA_ROOT/.env" を実行します。

4. Claude Code でそれを見えるようにする方法をユーザーに伝えます。.mcp.json の ${GITHUB_TOKEN} インターポレーションは Claude Code が起動されたシェル環境から読み込まれるため、ユーザーは以下のいずれかが必要です：

   オプション A — シェル rc で自動ソース（日常的な使用に推奨）:

   # ~/.bashrc または ~/.zshrc に追加
   set -a; [ -f "$HOME/.local/share/claude-plugins/gist-writer/.env" ] && . "$HOME/.local/share/claude-plugins/gist-writer/.env"; set +a
   

   （上記で解決した実際の $DATA_ROOT パスを使用します。）

   オプション B — 起動をラップ（グローバル環境を汚染したくない場合）:

   set -a; source "$DATA_ROOT/.env"; set +a; claude
   

   ユーザーの確認でオプション A をシェル rc に追加することを提案します。静かに実行しないでください。

5. 確認: 「トークンを $DATA_ROOT/.env に書き込みました。次の Claude Code セッションの前にシェルを再起動してください（またはファイルを source してください）。」

ユーザーが既に環境に GITHUB_TOKEN を設定している場合は、.env 書き込みをスキップし、既存の値が使用されることを記載するだけです。

注釈

• config.json はシークレットを含みません。.env はトークンのみを含みます。
• このスキルを再実行するのは安全です — JSON 設定の既存の値にマージされ、トークンが変更された場合は .env が書き直されます。