Claude Codeでランダム通知によるユーモア演出Skillの作り方入門

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

Claude Code を使っていると、日々の開発やリポジトリ操作の中で「ちょっとした息抜き」や「場の空気を和ませる」仕掛けが欲しくなることがある。特に長時間の AI coding workflow や、複雑な repository understanding が求められる作業では、真面目な雰囲気が続きすぎて気詰まりになりがちだ。

そんな時、OSやツールから突然表示される通知や警告にドキッとした経験は誰しもあるはず。けれど、実際の警告は大抵深刻な内容ばかり。もしこれが意味不明な内容だったら、思わず笑ってしまうかもしれない。Claude Code の context や path management、onboarding の合間に、ちょっとした演出が欲しいと感じる瞬間は意外と多い。

• 長時間 session で集中力が切れた時、ふとしたタイミングで笑える通知が欲しい
• onboarding や repo 構造説明の繰り返しで、場の空気が固くなりがち
• monorepo の directory 境界をまたいだ workflow で、気分転換になる演出が欲しい
• 重要な context を繰り返し説明している最中、無機質なやり取りが続いてしまう
• AI coding workflow の合間に、場を和ませるちょっとしたジョーク要素が足りない

「通知・演出・OS連携」カテゴリのSkillは、こうした日常の“隙間”を埋める役割も担える。

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

一言サマリ: このスキルは、開発現場に“謎のOSライセンス違反警告”をランダムで炸裂させることで、真面目な空気を一変させるジョーク演出ツール。

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

• AI coding workflow の合間に、意味不明かつ毎回異なる“ライセンス違反警告”が突然通知され、場が和む
• repository understanding や directory 操作中、OS風の演出でチームの緊張をほぐせる
• onboarding や長時間の session でも、context が固くなりすぎずリラックスした雰囲気を維持できる
• monorepo を跨いだ path management のタイミングで、ユニークな警告が挟まるため話題が生まれる
• Skill の発動タイミングや内容にランダム性があり、毎回新鮮な驚きと笑いを提供できる

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

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

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

# /random-os-fake-license-violation-alert
> session start

[Desktop Notification]
重大なOSライセンス違反を検出しました。
違反内容: 「キーボードJIS配列の無許可切替」
影響範囲: /src/components/keyboard/
対処方法: 配列切替の正当なライセンスを申請してください。

（閉じる）   （詳細）

シーン2: monorepo / package 跨ぎ作業時

> cd packages/api && /random-os-fake-license-violation-alert

[Desktop Notification]
警告: OSライセンス違反が発生しました。
違反内容: 「コーヒーブレイク無許可利用を検出」
影響範囲: packages/api/routes/
推奨対応: 一度席を立ち、正規のブレイク申請を行ってください。

（閉じる）   （詳細）

シーン3: お遊び的な使い方

> /random-os-fake-license-violation-alert

[Desktop Notification]
ライセンス違反警告
内容: 「椅子、座りすぎライセンス違反」
発生ディレクトリ: /docs/
コメント: 定期的な立ち上がりが推奨されています。

（閉じる）   （詳細）

before / after の違い

場面	Skill 無し	Skill 有り
session 再開時	repo 構造から毎回説明、path も指定し直し	Claude Code が自動で context を復元、最小プロンプトで再開
monorepo 移動	違う package のコードを参照しがち	directory boundary を意識して必要な範囲だけ見る
長時間 workflow	long context で重要箇所が薄まる	突如現れる謎警告で場が和み、集中力がリセットされる

発動方式

明示呼び出し (/random-os-fake-license-violation-alert) と暗黙発動 (警告風ワードや演出リクエストにマッチ) の両方に対応。

Skill の中身を全部見せる

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

.claude/skills/random-os-fake-license-violation-alert/
├── SKILL.md
├── scripts/
│   └── random_os_fake_license_violation_alert.py
└── references/
    └── design_notes.md

各ファイルの役割

ファイル	役割
SKILL.md	Skill本体。frontmatter (name/description) と指示本文。Claude Code がこの内容をエージェント指示として読み込み、ユーザーのプロンプトに応じて発動します
scripts/random_os_fake_license_violation_alert.py	謎のOSライセンス違反警告をデスクトップ通知で表示するジョークスクリプト
references/design_notes.md	概要 をまとめた参考資料

SKILL.md

---
name: random-os-fake-license-violation-alert
description: 作業中やコーディング中に“警告”や“違反”などのキーワードを含む状況や、明示的な /random-os-fake-license-violation-alert コマンドが呼ばれた際に発動します。通知演出で雰囲気を和ませたい時に最適です。
---

# 機能概要
このSkillは、作業中に突然“謎のOSライセンス違反警告”をデスクトップ通知として表示します。警告内容は毎回ランダムで、例えば「椅子の座りすぎライセンス違反」「コーヒーブレイク無許可利用」など、実際には存在しない意味不明な違反ばかり。真面目な雰囲気を一瞬で和ませたり、チーム内でのジョーク演出として活用できます。通知は本物のシステム警告風ですが、内容が明らかに冗談なので混乱も最小限です。

# 使い方
- 明示呼び出し例: `/random-os-fake-license-violation-alert`
- 暗黙発動キーワード例: 「警告」「違反」「ライセンス」「OSエラー」などの単語を含む発話や、セッション中の任意タイミングで自動発動

# 出力例
```
[デスクトップ通知]
タイトル: OSライセンス違反警告
内容: あなたの椅子、座りすぎライセンス違反を検出しました。直ちに立ち上がってください。

[デスクトップ通知]
タイトル: OSライセンス違反警告
内容: コーヒーブレイク無許可利用を検出しました。管理者に連絡してください。

[デスクトップ通知]
タイトル: OSライセンス違反警告
内容: 謎のキーボード配列違反が発生しました。再起動をおすすめします。
```

# 注意点
- 本Skillは冗談用であり、実際のシステムやライセンス違反とは無関係です。
- 通知内容は毎回ランダム生成されます。
- ログ保存や実際のシステム設定変更は行いません。
- 本物の警告と混同しないよう、内容に明らかなジョーク要素を含めています。

# 参考資料
- references/design_notes.md に設計方針や演出例を記載
- 公式Python通知API: https://pypi.org/project/plyer/

scripts/random_os_fake_license_violation_alert.py

import random
import time
import argparse
import sys
from threading import Thread
try:
    from plyer import notification
except ImportError:
    print("plyerモジュールが必要です。'pip install plyer'でインストールしてください。", file=sys.stderr)
    sys.exit(1)

VIOLATION_MESSAGES = [
    "あなたの椅子、座りすぎライセンス違反を検出しました。直ちに立ち上がってください。",
    "コーヒーブレイク無許可利用を検出しました。管理者に連絡してください。",
    "謎のキーボード配列違反が発生しました。再起動をおすすめします。",
    "OS標準フォント以外の利用が検出されました。違反ポイント加算中。",
    "マウスのクリック回数が1日上限を超過しました。ご注意ください。",
    "タスクバーのアイコン数が規定値を超えています。整理してください。",
    "キーボードショートカット無断拡張違反。管理者権限が必要です。",
    "スクリーンショット乱用違反が発生しました。",
    "ウィンドウ切替速度違反。OS推奨値を守ってください。",
    "仮想デスクトップの過剰生成違反。制限を超えています。",
    "壁紙の無断変更違反。デフォルトに戻してください。",
    "USB機器の抜き差し回数が多すぎます。違反記録中。",
    "OSアップデート先延ばし違反。すぐに更新してください。",
    "ディスプレイ明るさ調整違反。推奨値を超えています。"
]

TITLE = "OSライセンス違反警告"

class AlertLogger:
    def __init__(self):
        self.logs = []

    def log(self, msg):
        ts = time.strftime('%Y-%m-%d %H:%M:%S')
        self.logs.append({'time': ts, 'message': msg})

    def list_logs(self):
        return self.logs

    def summary(self):
        return f"合計{len(self.logs)}件の違反警告が発生しました。"

logger = AlertLogger()


def random_interval(min_sec=60, max_sec=300):
    return random.randint(min_sec, max_sec)


def show_notification(message):
    notification.notify(
        title=TITLE,
        message=message,
        app_name="FakeOSLicenseAlert",
        timeout=8
    )
    logger.log(message)


def alert_once():
    msg = random.choice(VIOLATION_MESSAGES)
    show_notification(msg)


def alert_loop(count=None, min_interval=60, max_interval=300):
    i = 0
    while count is None or i < count:
        alert_once()
        i += 1
        interval = random_interval(min_interval, max_interval)
        time.sleep(interval)


def cli():
    parser = argparse.ArgumentParser(description="謎のOSライセンス違反警告をデスクトップ通知で表示するジョークスクリプト")
    subparsers = parser.add_subparsers(dest='command')

    parser_alert = subparsers.add_parser('alert', help='1回だけ違反警告を表示')
    parser_alert.add_argument('--count', type=int, default=1, help='表示回数 (デフォルト1)')

    parser_loop = subparsers.add_parser('loop', help='定期的に違反警告を表示')
    parser_loop.add_argument('--min-interval', type=int, default=60, help='最短間隔(秒)')
    parser_loop.add_argument('--max-interval', type=int, default=300, help='最長間隔(秒)')
    parser_loop.add_argument('--count', type=int, default=None, help='表示回数 (未指定で無限)')

    parser_list = subparsers.add_parser('list', help='発生した違反警告の履歴を表示')
    parser_summary = subparsers.add_parser('summary', help='違反警告の発生件数サマリ')

    args = parser.parse_args()

    if args.command == 'alert':
        for _ in range(args.count):
            alert_once()
    elif args.command == 'loop':
        try:
            alert_loop(count=args.count, min_interval=args.min_interval, max_interval=args.max_interval)
        except KeyboardInterrupt:
            print("\n通知ループを中断しました。")
    elif args.command == 'list':
        logs = logger.list_logs()
        if not logs:
            print("違反警告履歴はありません。")
        else:
            for l in logs:
                print(f"[{l['time']}] {l['message']}")
    elif args.command == 'summary':
        print(logger.summary())
    else:
        parser.print_help()

if __name__ == '__main__':
    cli()

references/design_notes.md

# 概要
このSkillは、作業中に突然現れる“謎のライセンス違反警告”をデスクトップ通知で演出し、場の雰囲気を和ませるためのジョークツールです。通知内容は毎回ランダム生成され、実際のシステム警告と誤認しないよう十分に冗談要素を盛り込んでいます。

# 公式ドキュメント抜粋
通知表示にはPythonの plyer ライブラリ (https://pypi.org/project/plyer/) を利用しています。クロスプラットフォーム対応で、Windows/Mac/Linuxいずれでも動作します。

# 利用例
- チームの朝会やオンライン会議中に突然発動し、場を和ませる
- 長時間作業の合間に自動で“警告”を表示し、休憩を促すジョーク演出
- コマンドラインから明示的に呼び出してネタとして使う

# 注意点
- 本Skillは実際のライセンス違反やシステムエラーとは一切関係ありません。
- 通知内容は完全にランダム生成で、実害はありません。
- plyerの通知機能は一部環境で制限される場合があります。

# 設計方針
本物の警告に見せかけつつも、内容が明らかに冗談であることを重視。通知履歴やサマリ機能も実装し、繰り返し利用時の利便性を高めています。

導入手順

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

1. 前提

• Node.js v16 以上 (degit 実行に必要)
• Claude Code がローカルで動いていること

2. degit でフォルダ取得

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

npx degit aazutaku/ai-note/claude-code/random-os-fake-license-violation-alert .claude/skills/random-os-fake-license-violation-alert

.claude/skills/random-os-fake-license-violation-alert の中に SKILL.md / scripts/ / references/ / README.md が展開されます。

3. ファイル配置確認

ls .claude/skills/random-os-fake-license-violation-alert
# SKILL.md, scripts/, references/, README.md があればOK

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

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

5. 動作確認

/random-os-fake-license-violation-alert で呼び出すか、自然言語で発動条件にマッチする指示を出すと 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 を取りたい
• 気分転換したい瞬間: チームの雰囲気を和ませたい時や、集中力が途切れた時の演出用に

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

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

• 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
• 本物の警告との混同: Skill の通知がリアルすぎて、本物のOS警告と誤認されるリスク
• 通知のランダム性: 警告内容や発動タイミングが偏ると、ジョーク性が薄れる

試す前に確かめたいこと

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

• 実 repo での token 消費は許容範囲か?
• monorepo (packages 多数) で安定して動くか?
• stale context にならず、長時間 workflow でも有効か?
• CLAUDE.md との連携設計はどうあるべきか?
• 通知が期待通りランダムタイミングで出るか?
• 警告内容が毎回ユニークか（テンプレでなくランダム性あり）?
• 誤って本当のシステム警告と混同しない演出になっているか?

実際に Claude Code で試した検証ログは Claude Codeで謎のOSライセンス違反警告をランダム通知してみた！ にまとめる予定 (公開準備中の場合あり)。
あわせて Claude Code 公式ドキュメント と、本シリーズ「Claude Codeを便利にするSkill提案」の他記事も参照のこと。

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

本記事に付いているタグから、気になるテーマの記事を探せます。タグページで関連記事をまとめて読めるので、ぜひチェックしてみてください！

• Claude Code 向けのSkill提案・検証記事の一覧はこちら
• AI Coding Agent Skills の全記事の一覧はこちら
• AI Coding Agent (Claude Code / Codex / Antigravity) 全般の記事の一覧はこちら
• お遊び枠 – commit時に猫が鳴く・メニューバー進捗など、通知や演出系のSkill記事の一覧はこちら
• CLAUDE.md / AGENTS.md など常時参照されるSkill・指示ファイルの記事の一覧はこちら
• ai-note がAIで設計したSkillの提案記事一覧の一覧はこちら