コムテ

法人サイトSEO、AI検索で引用されるAI駆動開発｜3か月で40社以上（3割が上場企業）と商談｜toBメディアで5か月、問い合わせ0→14件｜SEO保守15年｜個人開発のプロダクト登録サービス 運営｜相談はDMで気楽にどうぞ

[コムテ @commte]

Claude 公式のブログがめちゃ参考になったので、分かりやすくまとめる。

「Claude は本来めちゃ賢い。でも Skill の書き方を間違えると、実力を自分で潰してる」という話

Claude は基本、かなり賢い前提で設計されている
だから人間向けの丁寧すぎる説明とか、背景知識の講義みたいなのを書くと、無駄なトークンが増えて判断精度が落ちるらしい

ここがまず重要な前提

Skill って「知識を教える場所」じゃなくて「行動を成功させるための設計図」なんよね。で、よくある失敗がこれ

Claude に不安になって、「念のため説明しとこ」「一応ここも書いとこ」ってやると、Skill が太って、コンテキストを圧迫して、結果として性能が下がる

公式が言ってるのはかなりドライで、

- Claude はもう十分賢い
- 本当に知らないことだけ書け
- 1 トークンごとに価値を疑え

という思想。次に出てくるのが「自由度」の話。タスクには性質があって、

- 壊れやすい処理
- 順序や正確さが命の処理

こういうのは、自由度を極限まで下げて「これを、そのまま、絶対にこの順でやれ」と書くべき

逆に、

- レビュー
- 分析
- 方針決め

みたいなやつは、ガチガチに縛ると逆に弱くなる。このへんは「判断の余地」をちゃんと残す。この自由度設計が、Skill の出来をほぼ決める

公式のたとえが面白くて、Claude を「道を進むロボット」に例えてる。崖だらけの細い橋なら、ガードレール必須。何もない草原なら、方向だけ示して放置でいい

Skill はこのガードレール設計の話

あと、めちゃ大事なのが name と description

Claude は起動時に、全 Skill の「名前と説明」だけをまとめて読み込む。つまり、

- ここで選ばれなかった Skill は
- SKILL .md がどれだけ良くても
- 一生読まれない

description には『何をするか』だけじゃなく『どんなときに使うか』まで書け、と強調している。ここが弱いと、そもそも Skill 候補に上がらない

で、SKILL .md 本体について

全部を書こうとするな、が原則。
SKILL .md は README じゃない。
目次であり、ナビゲーション。

必要になったら、

- reference .md
- examples .md
- forms .md

みたいな別ファイルを読ませる。これが Progressive Disclosure という考え方

ファイルは読まれない限りコンテキストを消費しない、という前提があるからこそ、目次に徹して、必要になった瞬間だけ別ファイルを読ませる設計が効く

全部最初から読ませるのは最悪。必要なときに、必要な分だけ。ただし注意点があって、「参照の参照」はやるな。

SKILL .md → A .md → B .md みたいな構造にすると、Claude が部分読みして事故る

SKILL .md から直接リンクする 1 段構造が安全。

次にワークフロー。複雑な作業は、文章で説明するな。チェックリストにしろ。

Claude 自身が「今どこまで終わったか」「次に何をやるか」を自己管理できる形がベスト。

さらに重要なのが、一発成功を前提にするな、という思想

実行 → 検証 → 修正 このループを最初から Skill に組み込む

特に Skill に含める処理については、Claude にコードを生成させるより、あらかじめ用意したスクリプトを実行させる方がいい、と言い切っている

理由は単純で、

- 再現性が高い
- 速い
- トークンを食わない

から。Skill に含めるスクリプトは「生成させるため」じゃなく「実行させるため」に置く

あと地味だけど重要なのが、時間依存の情報を書くな。「◯ 年 ◯ 月以降は〜」みたいなのは Skill を腐らせる。古い情報は Old patterns として隔離しろ、という設計

最後に一番思想的なところ

Skill は、評価から作れ。

まず Claude が失敗した実例を集める
それをテストケースにする
それを通すために、最小限の Skill を書く

想像で書いた Skill は、だいたい使われないってことらしい

まとめると、このページが言ってるのはこれ

- Claude を「何も分かってない新人」として扱うな
- 「めちゃ優秀だけど、事故るときは事故る同僚」として扱え
- Skill は知識集じゃない。判断ミスしやすい場所にだけ置くガードレール

[コムテ @commte]

@knaou @inuya110 作ったまま放置のシステムは特に危ないと思いますよね

[コムテ @commte]

@xjuntaro @gihyo_hansoku @sakamoto_582 @kangsoo_kim_ 偉業過ぎます😆この勢いで、これからもガンガンかましましょう笑

[コムテ @commte]

開発用Macの空き19→93GBにした手順

①resticでDriveへ暗号化バックアップ
②npm cache clean --force
③uv cache clean
④devを止め.next削除
⑤古いnode_modules削除
⑥DockerはDB書き出し→全削除→アプリ終了で仮想ディスク縮小

[コムテ @commte]

今度はこれか。Node.jsの脆弱性「Node2Shell」の記事を読んだ。圧縮データ(Brotli)を解凍する部分に穴があったらしいね。直し方はNode.jsのバージョンを上げるだけみたいなので、手元の環境とDockerイメージを順番に確認。こういうのは早めに片付けると気が楽

https://t.co/ioD5BgHZO7

[コムテ @commte]

@taku_taku_taku7 あるあるですね😆

[コムテ @commte]

Claude Code の ルーティン（PCを閉じた状態でもクラウド上でClaude Codeを自動実行）を使って本番エラーを毎朝 Discord に届ける仕組みをまとめました！

https://t.co/wIE9sK1KK0

[コムテ @commte]

@nao_aifounder なるほど！参考にします😆

[コムテ @commte]

ご報告ありがとうございます！
編集中の内容が消えてしまい、申し訳ありませんでした🙇‍♂️

アイキャッチのアップロード中に、編集画面が一度作り直される作りになっていました。本日修正し、アップロード中も編集中の本文はそのまま残るようになっています

開きっぱなしのタブがあれば、一度再読み込みしてからお使いください。また気になる動きがあれば、ぜひ教えてください

[コムテ @commte]

【お詫び】izanami で 10/9〜10/17 の間、画像のアップロードが反映されない不具合がありました🙏

現在は修正済みです。
この期間に記事やプロダクトの画像をアップロードした方は、お手数ですがもう一度アップロードをお願いします。

ご報告いただいた方、ありがとうございました！
https://t.co/2M7oeDl2xQ

[コムテ @commte]

@nomo_sn そうですよね！有名なCTOの方が公開しているところも素敵です

[コムテ @commte]

おぉ！IPAとJPCERT/CCの不正アクセス注意喚起をもとにした緊急点検のスキル化、いいですね。外部公開アプリ・外部サービス・保有データの点検に加えて、インシデント対応体制もチェックできるぞぅ

[Fado @fado_dev]

IPAの注意喚起(2026/10/9)とJPCERT/CCの注意喚起に沿って、外部公開アプリの緊急セキュリティ点検ができる手順書とスクリプトを公開しました。

・公開アプリ/外部サービス/保有データ/対応体制の4領域を点検
・異常時はCSIRTの対応フローでチェック
・Claude Code/Codex等のAIエージェント汎用対応

https://t.co/CWJrNL1vp8

[コムテ @commte]

@fado_dev 見ました！ありがとうございます
公開まで早い笑

[Fado @fado_dev]

Skillにするか！！

[コムテ @commte]

@kenfjt おぉ、流石です😆

[コムテ @commte]

IPAの不正アクセス緊急点検リスト。公開アプリ+外部サービスを部署単位まで洗い出し、直近1ヵ月からログ確認。エラー量やログイン元IP・時間帯を平時と比べ、不審アカウントや停止アカウントの復活を点検。未適用パッチは即適用。異常は即インシデント扱いで専門ベンダーへ
https://t.co/3nzAyDXmv4

[コムテ @commte]

シニアエンジニアの開発の進め方を守らせるためのスキル集。チームでAI開発の品質基準をそろえたい人にいいかも。開発ライフサイクルは、定義→計画→実装→検証→レビュー→リリースって感じで実にいい

[Miguel Ángel Durán @midudev]

¡Esta colección de skills tiene más de 100 mil estrellas!
Son 25 skills de Ingeniería de Addy Osmani.

✓ TDD, seguridad, review y Web Performance
✓ Spec, plan, build, test, review y ship
✓ Claude Code, Cursor, Codex...

→ https://t.co/LXVpnCyEnx

[コムテ @commte]

バイブコーディングの盲点。AIコーディングさせたサイト、別のMacで見るとアニメーションが全滅。原因はOSの「視差効果を減らす」設定ON。Claude Code がアクセシビリティの作法に従って、動きを止める処理を全部に入れてた。作法でも、出し分けは先に質問させたほうがいいね