MENU

Claude Codeで開発中の意外な混乱を演出する通知Skillの作り方

Skills Lab Claude Code
  • URLをコピーしました！
目次

Claude Code ユーザーが日常でぶつかる悩み

真面目な開発現場やリモートワークの静かな空間、Claude Code を使っているとどうしても作業が単調になりがちです。特に長時間のAI coding workflowでは、集中力が途切れたり、同じようなコマンドやディレクトリ移動の繰り返しに飽きてしまうことも。そんなとき、「ちょっとした変化」や「意外性」が欲しくなる瞬間はありませんか？

  • Claude Code でコマンドを実行するたび、何も起きず淡々と作業が進むので、集中が切れやすい
  • repository understanding や path management の説明を繰り返していると、気分転換のきっかけがなくなる
  • monorepo 内で directory を移動しても、環境の変化を感じにくく、作業の区切りがつかない
  • onboarding や session 再開時、長い context の説明に疲れてしまい、ちょっとした演出が欲しくなる
  • 周囲の開発者と同じ空間で作業していると、何か面白いことが起きて会話のきっかけが欲しい

通知・演出・OS連携の観点で、単調な作業に“謎の刺激”や“混乱”を加えたくなるのは、Claude Code ユーザーなら一度は感じる悩みです。

この Skill が一言でいうと何を解決するか

一言サマリ: このスキルは、Claude Code のコマンド実行時に謎のOS公式サウンドをランダム再生し、作業空間にシュールな変化と笑いをもたらすSkill。

もう少し具体化すると、このSkillを入れることで以下のような状態になる:

  • AI coding workflow の中で、コマンド実行ごとに“意味不明なSE”が鳴り、単調なsessionに意外性が生まれる
  • directory や repository を跨ぐたび、謎のサウンドで「今、環境が切り替わった」と体感できる
  • onboarding や長時間の作業時、音による刺激で context の切り替えや集中力の再起動が促される
  • 周囲の開発者との会話のきっかけや、チームの雰囲気を和ませる“混乱演出”が手軽に追加できる
  • Skill の導入・削除が簡単で、環境への影響を最小限に保てる
QUICK INSTALL
このSkillをすぐ試す

GitHub から degit でコマンド1行、Claude Code の Skill ディレクトリに展開できます。Node.js があれば即時に動きます。

npx degit aazutaku/ai-note/claude-code/random-os-mystery-sound-effect .claude/skills/random-os-mystery-sound-effect

実行したらこうなる (3つの利用シーン)

使う側がイメージしやすいよう、擬似 terminal で出力例を3パターン示します。

シーン1: session 開始時 (CLAUDE.md と組み合わせて)


# /random-os-mystery-sound-effect
> このリポジトリの構造を把握して、作業を始めて

[Claude Code] 
Skill の中身を全部見せる


.claude/skills/random-os-mystery-sound-effect/ に配置するファイル一覧です。GitHub に push 済みなので、上記の degit コマンドで一発取得できます。


.claude/skills/random-os-mystery-sound-effect/
├── SKILL.md
├── scripts/
│   └── random_os_mystery_sound_effect.py
└── references/
    └── design_notes.md


各ファイルの役割






ファイル
役割






SKILL.md
Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します




scripts/random_os_mystery_sound_effect.py
ランダムOS謎サウンドエフェクト Skill




references/design_notes.md
概要 をまとめた参考資料






SKILL.md


---
name: random-os-mystery-sound-effect
description: コマンド実行やファイル操作、プロジェクトビルドなどのアクション時に、毎回ランダムな“謎のOS公式サウンドエフェクト”を鳴らすことで、開発現場にシュールな混乱や笑いを演出したい場合に発動します。triggerType: always/semantic。
---

# 機能概要
このSkillは、ターミナルやエディタでコマンド実行のたびに、謎めいた“OS公式サウンドエフェクト”をランダムに再生します。音源は「ファイルが旅立つ音」「やる気起動音」「謎の自動拍手」など、用途や意味が不明なSEばかり。開発現場に突如シュールな混乱をもたらし、集中力を崩壊させるカオスな体験を提供します。通知や演出、OS連携カテゴリに最適です。

# 使い方
- 明示呼び出し: `/random-os-mystery-sound-effect` または `/skill random-os-mystery-sound-effect`
- 暗黙発動: `run`, `build`, `compile`, `test`, `deploy`, `save`, `commit` などのコマンド実行時に自動発動します。

# 出力例
```
$ git commit -m "fix typo"
[謎の自動拍手音が鳴る]
$ make build
[やる気起動音が鳴る]
$ rm -rf tmp/
[ファイルが旅立つ音が鳴る]
$ /random-os-mystery-sound-effect
[謎のシステム効果音が鳴る]
```

# 注意点
- サウンドファイルはローカルの .claude/skills/random-os-mystery-sound-effect/sounds/ に保存されます。
- Linux/macOSでは `aplay` または `afplay`、Windowsでは `winsound` を利用します。
- 音量や再生デバイスはOSの設定に依存します。
- サウンド再生が不要な場合はSkillを無効化/削除してください。

# 参考資料
- 参考: [Python公式sound再生](https://docs.python.org/ja/3/library/winsound.html), [afplay](https://ss64.com/osx/afplay.html), [aplay](https://man7.org/linux/man-pages/man1/aplay.1.html)
- 詳細は references/design_notes.md を参照してください。


scripts/random_os_mystery_sound_effect.py


import os
import sys
import random
import platform
import subprocess
import argparse
from pathlib import Path

SOUNDS_DIR = Path(__file__).parent / 'sounds'
SOUND_FILES = [
    'file_departure.wav',
    'motivation_boot.wav',
    'system_applause.wav',
    'mystery_effect1.wav',
    'mystery_effect2.wav',
    'weird_beep.wav',
    'unknown_notification.wav',
    'strange_popup.wav',
    'enigmatic_chime.wav',
    'cryptic_alert.wav',
]

# --- サウンド再生ヘルパー ---
def play_sound(sound_path):
    system = platform.system()
    try:
        if system == 'Darwin':
            # macOS
            subprocess.run(['afplay', str(sound_path)], check=True)
        elif system == 'Linux':
            subprocess.run(['aplay', str(sound_path)], check=True)
        elif system == 'Windows':
            import winsound
            winsound.PlaySound(str(sound_path), winsound.SND_FILENAME)
        else:
            print(f"[WARN] サウンド再生は未対応OSです: {system}")
    except Exception as e:
        print(f"[ERROR] サウンド再生失敗: {e}")

# --- サウンドファイルの存在チェック ---
def ensure_sound_files():
    missing = []
    for fname in SOUND_FILES:
        fpath = SOUNDS_DIR / fname
        if not fpath.exists():
            missing.append(fname)
    if missing:
        print("[WARN] 以下のサウンドファイルが見つかりません:")
        for m in missing:
            print(f"  - {m}")
        print(f"サウンドディレクトリ: {SOUNDS_DIR}")

# --- ランダム再生コア ---
def random_play():
    ensure_sound_files()
    available = [f for f in SOUND_FILES if (SOUNDS_DIR / f).exists()]
    if not available:
        print("[ERROR] 有効なサウンドファイルがありません。sounds/ ディレクトリを確認してください。")
        return
    sound = random.choice(available)
    sound_path = SOUNDS_DIR / sound
    print(f"[SE] {sound.replace('_', ' ').replace('.wav','')} を再生中...")
    play_sound(sound_path)

# --- サウンド一覧表示 ---
def list_sounds():
    print("利用可能なサウンドファイル:")
    for fname in SOUND_FILES:
        fpath = SOUNDS_DIR / fname
        status = "OK" if fpath.exists() else "Not found"
        print(f" - {fname} [{status}]")

# --- Skill概要表示 ---
def show_summary():
    print("random-os-mystery-sound-effect Skill")
    print("コマンド実行時にランダムな謎のOSサウンドエフェクトを再生します。")
    print(f"サウンドディレクトリ: {SOUNDS_DIR}")
    print(f"登録サウンド数: {len(SOUND_FILES)}")

# --- コマンドライン引数 ---
def main():
    parser = argparse.ArgumentParser(description='ランダムOS謎サウンドエフェクト Skill')
    subparsers = parser.add_subparsers(dest='command')

    subparsers.add_parser('play', help='ランダムでサウンドを再生')
    subparsers.add_parser('list', help='利用可能なサウンド一覧')
    subparsers.add_parser('summary', help='Skill概要表示')

    args = parser.parse_args()
    if args.command == 'play' or args.command is None:
        random_play()
    elif args.command == 'list':
        list_sounds()
    elif args.command == 'summary':
        show_summary()
    else:
        parser.print_help()

if __name__ == '__main__':
    main()



references/design_notes.md


# 概要
このSkillは、コマンド実行時にシュールな“OS謎サウンド”を再生し、開発現場の雰囲気を一変させる演出用ツールです。サウンドはローカル格納型で、OS標準の再生APIのみを利用しています。

# 公式ドキュメント抜粋
- [Python winsound](https://docs.python.org/ja/3/library/winsound.html)
- [afplay (macOS)](https://ss64.com/osx/afplay.html)
- [aplay (Linux)](https://man7.org/linux/man-pages/man1/aplay.1.html)

# 利用例
- チーム開発での気分転換
- コマンド実行の成功/失敗時の演出
- ハッカソンやイベントでの混乱演出

# 注意点
- サウンドファイルは .claude/skills/random-os-mystery-sound-effect/sounds/ に配置してください。
- 音量・再生デバイスはOS設定依存です。
- サウンド再生が不要な場合はSkillを削除/無効化してください。

# 設計方針
- OS標準APIのみ利用し、追加ライブラリ不要
- サウンドファイルはSkill配下に限定
- 導入・削除が容易で環境に影響を残さない設計


導入手順


このSkillは GitHub で管理されているので、degit を使えば必要なフォルダだけを1コマンドで取得できます。Claude Code はファイル配置後に再起動するだけで自動認識します。


1. 前提


    

  • Node.js v16 以上 (degit 実行に必要)
    • 

  • Claude Code がローカルで動いていること
    • 



2. degit でフォルダ取得


プロジェクトのルートで以下のコマンドを実行します。


npx degit aazutaku/ai-note/claude-code/random-os-mystery-sound-effect .claude/skills/random-os-mystery-sound-effect


.claude/skills/random-os-mystery-sound-effect の中に SKILL.md / scripts/ / references/ / README.md が展開されます。


3. ファイル配置確認


ls .claude/skills/random-os-mystery-sound-effect
# SKILL.md, scripts/, references/, README.md があればOK


4. Claude Code を再起動 (or Skill 自動検出を待つ)


新しいSkillが自動で認識されます。リスト確認したい場合は /random-os-mystery-sound-effect と Skill 名で出てきます。


5. 動作確認


/random-os-mystery-sound-effect で呼び出すか、自然言語で発動条件にマッチする指示を出すと Skill が動きます。期待される出力イメージは「実行したらこうなる」セクションを参照してください。


こんな瞬間に便利


    

  • session 開始時: 前回までの repo 把握を Claude Code に一発で復元させたい
    • 

  • monorepo 移動時: packages を跨いだ瞬間に context を切り替えたい
    • 

  • onboarding 時: 新しい repo を Claude Code に把握させ、こちらが path を全部指定する手間を省きたい
    • 

  • session 再開時: long context が切れた後でも、必要な path と directory 構造だけ素早く戻したい
    • 

  • package 跨ぎ作業時: directory boundary を Skill 側で管理して、irrelevant な path 混入を防ぎたい
    • 

  • long-running workflow 前: long context で重要箇所が薄まる前に snapshot を取りたい
    • 

  • 単調な作業に変化を加えたいとき: コマンド実行ごとにシュールなSEで気分転換したい場合
    • 

  • チームの雰囲気を和ませたいとき: 周囲の反応や会話のきっかけに
    • 



気になるポイント (壊れそうな箇所)


実運用に乗せる前に頭に入れておきたい懸念。後で検証する観点でもある:


    

  • stale context 問題: 長時間 workflow で Skill 出力が古くなり、現状と乖離する可能性
    • 

  • directory 増えすぎ問題: 大規模 repo で全 directory を網羅すると出力が肥大化して context window を圧迫
    • 

  • monorepo 肥大化: packages が多い構成では出力が雑になり、結局 path 指定し直しになる懸念
    • 

  • irrelevant path 混入: node_modules / build 成果物 / generated コードを拾ってしまう可能性
    • 

  • Claude Code 固有の引っかかり: paths フロントマターでの絞り込みを使わないと意図しないタイミングで発動する
    • 

  • 発動しないケース: description が漠然 / 他の Skill が優先 / git管理外 directory
    • 

  • 音量・サウンド環境依存: サウンドが正しく再生されないOS環境や、無音PCでは効果を体感できない場合がある
    • 



試す前に確かめたいこと


この Skill を実運用に投入する前に確かめたい問いを並べる:


    

  • 実 repo での token 消費は許容範囲か?
    • 

  • monorepo (packages 多数) で安定して動くか?
    • 

  • stale context にならず、長時間 workflow でも有効か?
    • 

  • CLAUDE.md との連携設計はどうあるべきか?
    • 

  • 音がコマンド実行のたび毎回ランダムで鳴るか?
    • 

  • 謎のSEが複数種用意されているか?
    • 

  • 導入・削除が簡単で環境に影響を残さないか?
    • 



実際に Claude Code で試した検証ログは Claude Codeで謎のOS公式サウンドを鳴らしてみた！ にまとめる予定 (公開準備中の場合あり)。

あわせて Claude Code 公式ドキュメント と、本シリーズ「Claude Codeを便利にするSkill提案」の他記事も参照のこと。


関連タグで他のSkill記事を探す


本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください！
Skills Lab Claude Code
AI Coding Agent Claude Code Skills 常時参照Skill 提案 通知・演出・OS連携

この記事が気に入ったら
フォローしてね！

よかったらシェアしてね！
  • URLをコピーしました！
  • URLをコピーしました！

関連記事

© AI Note

目次