Communitygithub.com

AlemTuzlak/skills

ユーザーが/prove-itを実行したり、「証明して」「変更点を証明して」「ブラウザで見せて」などと言った場合に使用します。エージェントが完了しようとしているからといって、タイプのみの作業や動作を証明する必要のないドキュメントに対しては使用しないでください。

skills とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)に対して、コード変更を実際にユーザーが操作する方法で「証明」することを強制する厳格な手順書です。ユーザーが明示的に「証明して」と依頼した場合のみ起動し、ブラウザでのUI操作(クリック、入力、送信、画面遷移)やサーバー/APIの動作確認(curlスクリプトなど)を通じて、変更が実際に期待通りに動作することを確認します。単なるスクリーンショットや「テストが通ったから」という理由での完了宣言を禁止し、スキルが起動したサーバープロセスは必ず停止することを要求します。また、ユーザーが許諾していない新しいパッケージや依存関係の追加も禁止します。証明が完了した後は、オプションで画面レポートを`.agent/scratch/prove-it.md`に出力できます。このスキルは、UI変更、サーバー/API変更、またはその両方の証明をサポートし、決定木に従って適切な手順を選択します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/prove-it

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

証明せよ (Prove It)

変更を、ユーザーが実際に使用する方法で証明せよ。証明なしに「動作します」と主張してはならない。

このスキルは「完了」時に自動でロードされない。ユーザーが依頼しなければならない。他のスキルをロードしない。

使用するタイミング

以下の場合にロードする:

  • ユーザーが /prove-it を実行した時
  • 「証明して」、「変更点を証明して」、「ブラウザで見せて」、または同様の意図を発言した時(最初のメッセージも含む)

ユーザーが依頼していなければスキップする。タイプのみ、コメント、ロックファイル、動作を伴わないドキュメントはスキップする。

厳格なゲート

  1. ユーザーが依頼したこと。 証明を依頼していなければ、このスキルは実行されない。
  2. 「動作します」「完了しました」「修正されました」と言ってはならない。 このスキルが実際に証明した場合を除く。スキップは「証明されていない」を意味する。
  3. 1つの画面のスクリーンショットは証明ではない。 クリック、入力、送信、ナビゲートせよ。
  4. 新しいパッケージ、依存関係、サンプルアプリ、ブラウザランナーを追加してはならない。 ユーザーがその選択肢を選び、同意した場合を除く。
  5. このスキルが起動したサーバーは、スキル終了前に停止せよ。 dev/preview を実行したままにしてはならない。

UI vs サーバー

  • UI(ページ、コンポーネント、ルート、フォーム、可視状態): ブラウザで証明せよ。
  • サーバー / API / 画面のないライブラリ: 証明方法を質問せよ。黙って選択してはならない。
  • 両方: ブラウザでUIを証明し、かつサーバー側の証明方法を質問せよ。

手順

手順 1: 分類

  1. 証明対象を列挙する: UI、サーバー/API、またはその両方。
  2. UI → 手順 2。
  3. サーバー/API → 手順 3。
  4. 両方 → 手順 2、その後APIについては手順 3。

手順 2: ブラウザ (UI)

  1. アプリが起動していない場合、既存のコマンドのみを開始する(dev、preview、リポジトリのドキュメントに記載された起動コマンド)。存在しない場合は、UIは証明できないと伝える。スキップするか、ユーザーがアプリを起動することを提案する。
  2. ユーザーのように使用する:
    • クリック、タイプ、送信、ナビゲートする
    • この状態を共有するすべてのルート/ページ
    • この変更に関連する空のUIとエラーUI
    • レイアウトやCSSが変更された場合、デスクトップと狭いビューポートの両方
  3. ハッピーパスだけでなく、破損を探す。
  4. チャットで、何を実行し、何を見たかを伝える。手順なしで「問題なさそうです」と言ってはならない。
  5. このスキルがプロセスを開始した場合、手順1のプロセスを停止する。
  6. 手順 4。

手順 3: 質問 (サーバー / API)

  1. 停止する。2~3の選択肢を表示する。最初に妥当な最初の選択肢を置く。常にスキップを含める。
    • 既存のサンプル/プレイグラウンド/デモ
    • 新しいAPIを使用するサンプルアプリ(場所と新しいパッケージ/依存関係の確認がある場合のみ)
    • 実行中のサーバーに対するcurlまたは小さなスクリプト
    • スキップ
  2. 待つ。ユーザーが選択するまで、ビルドや実行を行わない。
  3. スキップの場合: 証明されていないと伝える。「動作します」と言ってはならない。停止する(手順4は不要)。
  4. 既存のプレイグラウンドの場合: それを実行し、UIがあればブラウザで証明する。スクリプトの場合はコマンド出力を表示する。
  5. サンプルアプリの場合: 場所を質問する。既存のサンプルを優先する。ユーザーが同意しない限り、パッケージや依存関係を追加してはならない。その後実行し、証明する。
  6. curl/スクリプトの場合: 実行する。終了コードと、主張を証明する出力の部分を引用する。
  7. 手順 4。

手順 4: オプションのレポート

  1. 実際の証明後、スクリーンショットレポートを書くか質問する。デフォルトはいいえ。
  2. 「いいえ」の場合: 停止する。チャットに既に証拠がある。
  3. 「はい」の場合: .agent/scratch/prove-it.md に書き込む(上書き)。.agent/scratch/ が存在しない場合は .gitignore に追加する(他のスクラッチファイルと同様)。クリックした内容とスクリーンショットを含める。ファイルを開く。コミットしてはならない。
  4. 証明をスキップした場合 → レポートは不要。

手順 5: 停止

証明またはスキップの後、停止する。このスキルから無関係な作業を開始してはならない。

決定木

  • ユーザーが証明を依頼していない → このスキルは適用されない。
  • UI → 手順 2 → 4 → 5。
  • サーバー/API → 手順 3 → 4 → 5(スキップは手順3で終了)。
  • 両方 → 手順2、次に手順3、その後手順4 → 5。
  • 開始コマンドがなく、アプリが起動していない → UIは証明できないと伝える。スキップするか、ユーザーが起動する。
  • ユーザーがスキップと言った → 証明されていない。成功の主張はしない。

レッドフラグ

シグナル意味代わりに行うこと
テストが通ったから完了と言うこのスキルが依頼されていない、または証明がスキップされた手順2または3の後にのみ証明済みと主張する。
1つのスクリーンショット、クリックなしユーザーパスではない手順2のステップ2。
ユーザーが選択する前に examples/foo をビルドする依頼されていないアプリ手順3。待つ。
Playwright / 新しいサーバーを追加する新しい依存関係既存の開始コマンドのみ。
pnpm dev を実行したままにするウォッチャーが残っている厳格なゲート5。
「スキップしますが、動作します」スキップを主張に変える証明されていないと伝える。
docs/ 内のレポートファイル製品ドキュメント.agent/scratch/prove-it.md。
ユーザーが「いいえ」と言ったのにレポートを開く依頼されていないファイル手順4のデフォルトは「いいえ」。
新しい公開APIに対してページのみを証明するサーバー側が黙ってスキップされたAPIについては手順3。

エラーハンドリング

  • ブラウザツールがない: UIはここでは証明できないと伝える。スキップするか、URLを待っている間にユーザーがクリックすることを提案する。スクリーンショットを偽造してはならない。
  • 起動コマンドが失敗する: エラーを引用する。UIが動作すると言ってはならない。修正を提案するかスキップを提案し、その後再度証明する。
  • 証明が失敗する(クリックが間違った動作をする、curlが200以外を返す): 証明されていないと伝える。何が失敗したかを明示する。「完了」とは言わない。
  • ユーザーがサンプルアプリを選んだ後、新しいパッケージの追加を拒否する: curl、既存のサンプル、またはスキップを使用する。パッケージを強制的に追加してはならない。
  • スクラッチへの書き込みに失敗する: 証拠はチャットに残す。レポートファイルが書き込まれなかったと伝える。

他には何も見ないこと。チャットがデフォルトの証拠である。Markdownファイルはオプションである。

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

関連スキル