dotfiles

cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。

Preview generated Markdown (plans, design notes, reviews, research reports) in the user's browser. Use when sharing long, structured output — documents with headings, tables, code blocks, or Mermaid diagrams — that is hard to read in the terminal.

バグを場当たり修正せず、根本原因を特定してから直すためのデバッグ手順。再現→切り分け→根本原因→検証の順で進める。バグ・デバッグ・原因不明・落ちる・再現しない・CIが赤・flakyなテスト・想定外の挙動に遭遇したときに使用する。「デバッグして」「なぜ落ちる」「原因を調べて」などのときにも使用する。

「完了」「直した」と報告する前に、実際に実行・テスト・観察して根拠を確かめるための検証ルール。修正・実装・リファクタが終わって成功を報告しようとするとき、変更が意図どおり動くと主張する前に使用する。「できた」「直した」「実装した」「修正完了」と言おうとしているときに使用する。

日本語の技術文書を書いた後・公開前にレビューし、重要度つきの指摘レポートを出すスキル（ファイルは変更しない）。日本語の文章品質・AI Slop・表記の慣習・整合性・独自性・語り口を点検する。媒体非依存の汎用版で、ブログMDXなどプロジェクト固有のレビュースキルがあればそちらを優先・併用する。

新しい k8o プロジェクト/リポジトリを立ち上げる一連の手順。@k8o/create で雛形生成 → GitHub リポジトリ作成 → ブランチ保護 ruleset とマージ設定 → リリース用 secret(fnox経由) → npm 初回 publish と Renovate 有効化まで。「新しい repo を作る」「プロジェクトを立ち上げる」「リポジトリの初期設定をする」ときに使用する。

Conventional Commitsに従ったアトミックなgitコミットを作成する。変更を論理単位に分割し、独立してrevert可能なコミットを生成する。コードの変更をコミットしたいとき、コミットメッセージを作りたいときに使用する。

PRワークフローを最初から最後まで管理する。ブランチ作成、コミット、プッシュ、プルリクエストのオープンまでを行う。「PRを作って」「この変更をプッシュしてPRを作って」などのときに使用する。

実装や設計に入る前にユーザーを徹底的にインタビューし、認識を一致させる。設計を決定ツリーとして捉え、上流の選択から1問ずつ潰していく。曖昧な依頼を確かな仕様に変えたいとき、計画段階で見落としや不整合を洗い出したいときに使用する。「grill me」「詰めて」「設計を固めたい」「実装前に整理して」などのときにも使用する。

長時間実行タスクや複雑な実装にHarness設計パターンを適用する。Planner/Generator/Evaluatorの分離、スプリント分割、品質ループ、ファイルベースのハンドオフを行う。大きな機能実装、長時間のコーディングタスク、品質の担保が重要な作業に使用する。

モダンなWeb開発のベストプラクティスを検索・参照するスキル。HTML/CSS/クライアントサイドJSの実装タスクでは最初に必ず参照する。Web APIは急速に進化しており、モデルの学習データには時代遅れのパターンが多く含まれているため、本スキルで最新の推奨実装を確認する。 以下のテーマで即座に利用する： - UI/レイアウト：モーダル、ダイアログ、ポップオーバー、グラスモーフィズム/backdrop-filter、anchor positioning、コンテナクエリ、`:has()`、`:user-valid` - スクロール/モーション：View Transitions、スクロール駆動アニメーション、パララックス/スクロールリビール - パフォーマンス：Core Web Vitals（LCP、INP）、content-visibility、Fetch Priority、画像最適化 - システム/API：ローカルファイル、WebUSB、WebSocket同期、WebAssembly - フレームワーク：React/Vue/Angular でのレイアウト・スタイル適応 - 一般フロントエンド：フォーム、autofill、高度な入力、カスタムスクロールバー、モダンなコンポーネント状態など 以下では使用しない： - バックエンド：データベースSQL、ORM、Express API ルート - パイプライン：CI/CD、Docker、GitHub Actions - 一般：Python/Go のローカルスクリプト、ESLint、Git

OpenAI Codex CLIを使ってコードや計画に対する外部視点のレビューを取得する。計画の妥当性確認、複雑な問題で行き詰まったとき、アーキテクチャ判断のセカンドオピニオン、難しいデバッグのときに使用する。「Codexに聞いて」「セカンドオピニオンが欲しい」などのリクエストにも対応する。

difitを使ったローカルコードレビュー。コード変更後にユーザーにレビューを促す、特定のdiffやPRをレビューしてコメント付きで表示する。コード変更のレビュー、diff確認、PR確認のときに使用する。

k8oが好むUIデザインの方針。UIコンポーネントの作成、画面デザイン、スタイリングの判断時に使用する。ArteOdysseyを使うプロジェクトではコンポーネントやトークンの具体的な使い方を、それ以外のプロジェクトではデザインの方向性を提供する。自由にデザインを作るとき、見た目の判断に迷ったとき、UIレビュー時にも使用する。

Reactの正しい書き方を徹底するスキル。useRef/useStateの使い分け、useEffectの適切な使用と代替API、React 19の最新機能、Concurrent Modeに沿った記述を指導する。Reactコンポーネントの作成・修正・レビュー時に使用する。古いReactパターンを避け、現代のAsync Reactに沿ったコードを書く。

スキルの新規作成・編集・改善を行うためのスキル。ユーザーがスキルを一から作りたい、既存のスキルを改善したい、スキルの書き方を知りたいときに使用する。

テストの記述ガイドライン。テストを書くとき、テスト設計を考えるとき、テスト戦略を議論するときに使用する。テストの目的、構成、書き方の原則に基づき、信頼性が高く保守しやすいテストを書く。

agent-browser（Rust製ヘッドレスブラウザCLI）を使ったブラウザ自動化。Webページの操作、スクレイピング、フォーム入力、スクリーンショット取得、E2Eテスト的な操作を行うときに使用する。