k-skill セットアップ

目的

k-skill 全体のインストール完了後、共通の後続作業を処理します。

• credential の確保（エージェント vault または デフォルト secrets.env）
• ランタイム環境変数の確認
• オプション：定期的な更新確認の自動化
• オプション：GitHub star の確認と同意時の実行

このスキルの基本方針：

• シークレットがない場合、必要な値の名前をユーザーに正確に伝える
• credential resolution order に従って確保する
• 必要なパッケージがない場合、代替実装を探すより先にグローバルインストールを試みる
• cron、launchd、schtasks、gh のような永続化・外部状態の変更は自動で行わず、先にユーザーの同意を取得する
• GitHub star はユーザーが明示的に同意した場合のみ実行する

Credential resolution order

credential を扱うすべてのスキルは、以下の優先順位に従います。

1. 既に環境変数にあれば、そのまま使用する
2. エージェント自身が secret vault（1Password CLI、Bitwarden CLI、macOS Keychain など）を使用している場合、そこから取得して環境変数として注入してもよい
3. ~/.config/k-skill/secrets.env（デフォルト fallback）— plain dotenv ファイル、パーミッション 0600
4. 何もない場合、ユーザーに確認して 2 または 3 に保存する

デフォルトパスへの保存は fallback に過ぎず、強制ではありません。

標準ファイルロケーション

• secrets ファイル（デフォルト fallback）：~/.config/k-skill/secrets.env

インストール

このスキルは k-skill 全体のスキルインストール完了後に実行することを想定しています。

例：

npx --yes skills add <owner/repo> --all -g

インストール完了後、このスキルを呼び出して以下のセットアップステップを進めます。

セットアップステップ

1. デフォルト secrets ファイルの作成（vault を使用していない場合）

エージェントが自身の vault を使用していない場合、デフォルト fallback ファイルを作成します。

mkdir -p ~/.config/k-skill
cat > ~/.config/k-skill/secrets.env <<'EOF'
KSKILL_SRT_ID=replace-me
KSKILL_SRT_PASSWORD=replace-me
KSKILL_KTX_ID=replace-me
KSKILL_KTX_PASSWORD=replace-me
KSKILL_FORESTTRIP_ID=replace-me
KSKILL_FORESTTRIP_PASSWORD=replace-me
LAW_OC=replace-me
KIPRIS_PLUS_API_KEY=replace-me
AIR_KOREA_OPEN_API_KEY=replace-me
KSKILL_PROXY_BASE_URL=
EOF
chmod 0600 ~/.config/k-skill/secrets.env

ユーザーに確認して実際の値を入力します。

ソウル地下鉄到着情報、韓国の天気、微細粉塵、漢江水位、給油所価格、生活ゴミ排出情報照会、学校給食献立照会、医薬品安全チェック、食品安全チェックは、KSKILL_PROXY_BASE_URL を空のままにするとデフォルトの hosted path（k-skill-proxy.nomadamas.org）をそのまま使用します。別の self-host proxy を使用する場合のみ KSKILL_PROXY_BASE_URL を入力します。

韓国法令検索はローカル korean-law-mcp パスを使用する場合のみ LAW_OC を入力します。remote endpoint は url だけを登録すれば、ユーザー側の LAW_OC は不要です。既存パス障害時は 법망（https://api.beopmang.org）を fallback として案内します。

韓国不動産実거래가照会はデフォルト hosted proxy（k-skill-proxy.nomadamas.org）を経由するため、ユーザー側の DATA_GO_KR_API_KEY は不要です。

韓国株式情報照会はデフォルト hosted proxy（k-skill-proxy.nomadamas.org）を経由するため、ユーザー側の KRX_API_KEY は不要です。self-host proxy 運営者のみサーバー環境変数 KRX_API_KEY を使用します。

図書館図書照会はデフォルト hosted proxy（k-skill-proxy.nomadamas.org）を経由するため、ユーザー側の DATA4LIBRARY_AUTH_KEY は不要です。self-host proxy 運営者のみサーバー環境変数 DATA4LIBRARY_AUTH_KEY を使用します。

生活ゴミ排出情報照会は k-skill-proxy の /v1/household-waste/info ルートを呼び出し、serviceKey（DATA_GO_KR_API_KEY）は proxy サーバーで注入・管理されるため、ユーザー側の DATA_GO_KR_API_KEY は不要です。

学校給食献立照会は k-skill-proxy の /v1/neis/school-search・/v1/neis/school-meal を呼び出し、KEDU_INFO_KEY は proxy サーバーのみにあるため、ユーザー側に置く必要がありません。

図書館図書照会は k-skill-proxy の /v1/data4library/* ルートを呼び出し、DATA4LIBRARY_AUTH_KEY は proxy サーバーのみにあるため、ユーザー側に置く必要がありません。

近くで最も安い給油所を探すはデフォルト hosted proxy を経由するため、ユーザー側の OPINET_API_KEY は不要です。

医薬品安全チェックは k-skill-proxy の /v1/mfds/drug-safety/lookup ルートを呼び出し、DATA_GO_KR_API_KEY は proxy サーバーでのみ注入・管理されるため、ユーザー側に置く必要がありません。

食品安全チェックは k-skill-proxy の /v1/mfds/food-safety/search ルートを呼び出し、DATA_GO_KR_API_KEY および オプショナルな FOODSAFETYKOREA_API_KEY は proxy サーバーでのみ注入・管理されるため、ユーザー側に置く必要がありません。

韓国特許情報検索は KIPRIS Plus Open API パスを使用する場合に KIPRIS_PLUS_API_KEY を入力します。helper はこの値を読んで実際のリクエストで ServiceKey クエリパラメータとして送信します。公共データポータルからコピーした percent-encoded キーもそのまま入力できます。

認証スキルで値が不足している場合のレスポンステンプレート

認証スキルで値が足りない場合、credential resolution order に従って確保します。

必要な値の例：

• SRT：KSKILL_SRT_ID、KSKILL_SRT_PASSWORD
• KTX：KSKILL_KTX_ID、KSKILL_KTX_PASSWORD
• 自然休養林空室照会：KSKILL_FORESTTRIP_ID、KSKILL_FORESTTRIP_PASSWORD
• ローカル韓国法令検索：LAW_OC + korean-law-mcp
• 韓国法令検索 remote endpoint：ユーザー側 LAW_OC なしで url のみ登録、障害時 법망 fallback
• 韓国不動産実거래가照会：ユーザー側シークレット不要（デフォルト hosted proxy 使用）
• 韓国特許情報検索：KIPRIS_PLUS_API_KEY
• 韓国株式情報照会：ユーザー側シークレット不要（デフォルト hosted proxy 使用、運営者のみ KRX_API_KEY）
• 生活ゴミ排出情報照会：ユーザー側シークレット不要（serviceKey は proxy サーバー注入、呼び出し時 pageNo=1・numOfRows=100 必須）
• 学校給食献立照会：ユーザー側シークレット不要（KEDU_INFO_KEY は proxy サーバーのみ）
• 図書館図書照会：ユーザー側シークレット不要（DATA4LIBRARY_AUTH_KEY は proxy サーバーのみ）
• 医薬品安全チェック：ユーザー側シークレット不要（DATA_GO_KR_API_KEY は proxy サーバーのみ）
• 食品安全チェック：ユーザー側シークレット不要（DATA_GO_KR_API_KEY および オプショナルな FOODSAFETYKOREA_API_KEY は proxy サーバーのみ）
• 近くで最も安い給油所を探す：ユーザー側シークレット不要（デフォルト hosted proxy 使用）
• ソウル地下鉄：ユーザー側シークレット不要（デフォルト hosted proxy 使用、運営者のみ SEOUL_OPEN_API_KEY）
• ソウルリアルタイム混雑度：ユーザー側シークレット不要（デフォルト hosted proxy 使用、運営者のみ SEOUL_OPEN_API_KEY）
• 韓国の天気：ユーザー側シークレット不要（デフォルト hosted proxy 使用、運営者のみ KMA_OPEN_API_KEY）
• ユーザー位置微細粉塵照会：KSKILL_PROXY_BASE_URL または AIR_KOREA_OPEN_API_KEY

シークレットが空という理由で、自動的に他のサービスや非公式な回避経路を選択しないでください。

2. ランタイム環境の確認

bash scripts/check-setup.sh

3. 定期更新確認の提案

セットアップ完了後、ユーザーに定期的な更新確認の自動化を望むか最初に確認します。望まない場合はスキップします。

基本方針：

• 自動インストールではなく、「更新確認」のみデフォルトで提案する
• 永続化のあるシステム変更（crontab、launchd、schtasks）は同意なしで適用しない
• デフォルト確認コマンドは npx --yes skills check
• ユーザーが明示的に「自動更新」を望む場合のみ、npx --yes skills update ベースのスケジュールを別途提案する

macOS / Linux の例：

mkdir -p ~/.config/k-skill/bin ~/.config/k-skill/logs
cat > ~/.config/k-skill/bin/check-skill-updates.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
mkdir -p "$HOME/.config/k-skill/logs"
{
  date '+[%Y-%m-%d %H:%M:%S]'
  npx --yes skills check
  printf '\n'
} >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
EOF
chmod +x ~/.config/k-skill/bin/check-skill-updates.sh
(crontab -l 2>/dev/null; echo "0 9 * * * $HOME/.config/k-skill/bin/check-skill-updates.sh") | crontab -

Windows の例：

New-Item -ItemType Directory -Force "$HOME/.config/k-skill/bin" | Out-Null
New-Item -ItemType Directory -Force "$HOME/.config/k-skill/logs" | Out-Null
@'
npx --yes skills check >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
'@ | Set-Content "$HOME/.config/k-skill/bin/check-skill-updates.cmd"
schtasks /Create /SC DAILY /TN "k-skill-update-check" /TR "\"$HOME/.config/k-skill/bin/check-skill-updates.cmd\"" /ST 09:00 /F

設定後はログの場所を簡潔に伝えます：

• ~/.config/k-skill/logs/skills-check.log

4. 明示的な同意による GitHub star の提案

セットアップの最後には、次のように簡潔に質問します。

k-skill リポジトリ（NomaDamas/k-skill）に GitHub star を付けますか？
ご希望の場合は `gh` で直ちに処理し、ご希望でない場合はスキップします。

ルール：

• ユーザーが明示的に同意する前に gh repo star を実行しない
• gh がない、または認証されていない場合、インストール・ログインの案内のみを行い、自動で回避しない
• star の対象リポジトリは NomaDamas/k-skill です

同意し、gh auth status が正常な場合：

gh repo star NomaDamas/k-skill

成功時は簡潔に完了のみを通知します。

完了チェックリスト

• ~/.config/k-skill/secrets.env がパーミッション 0600 で存在する（またはエージェントが自身の vault で credential を管理中）
• 必要な環境変数が設定されている
• ユーザーが望む場合のみ、更新確認の自動化または GitHub star が設定されている

メモ

• デフォルトフロー：「スキル全体インストール → このセットアップスキル実行 → 個別機能使用」
• リポジトリ内にシークレットファイルを置かない