Skip to content

Latest commit

 

History

History
116 lines (72 loc) · 5.96 KB

File metadata and controls

116 lines (72 loc) · 5.96 KB

codeck

skill は channel。codeck は deck room。

Live demo →

English | 简体中文 | 繁體中文 | 日本語 | 한국어

フォルダにメモ、ドキュメント、データ、画像がある。プレゼンを作りたい。/codeck と打つ。

codeck は永続的な deck room を開く。各 codeck skill は、その room に channel として入る。outline、design、review、speech、export。

channel にはアドレス、書き込み境界、room files、handoff がある。room は現在の deck state を ~/.codeck/projects/{slug}/ に保持するので、chat memory に頼らず次の実行でも続きから作業できる。

出力は単一の HTML ファイル。テンプレートなし。スライドタイプの制約なし。各ページは自由な HTML で構成される。AI はあなたのコンテンツに必要などんな視覚表現でも発明できる。

使い方

/codeck が room を開き、プロジェクトを読む。outline channel がストーリーを形にする。design channel がストーリーに視覚形式を与える。review channel が最も手厳しい聴衆のように問い返す。speech と export channel が発表と配布を準備する。

handoff は chat history ではなく room に残る。

3つのアイデア

skill は channel。 codeck は、チームのふりをした長い prompt ではない。各 skill は room の中に 1 つの channel を持つ。何を受け取り、何を書き、誰へ handoff するかが決まっている。

同型写像。 デザインの前に、codeck はコンテンツの形式構造を分析する。テンションカーブ、情報密度、感情のアーク。そして別の領域から構造的に対応するものを見つける。楽曲、絵画様式、建築原理。スライドはあなたの議論を格納するだけでなく、議論と同じ形をしている。(ホフスタッター『ゲーデル、エッシャー、バッハ』に触発。)

スキーマの天井がない。 多くのスライドツールはブロックタイプの語彙を与える——タイトル、箇条書き、画像、引用。codeck は AI に自由な HTML を渡す。コンテンツがまだ名前のない視覚形式を必要とするなら、AI がそれを発明する。

インストール

Claude Code(推奨)

/plugin marketplace add hiyeshu/codeck
/plugin install codeck@codeck

/codeck と打てば始まる(プラグイン名前空間では /codeck:codeck と表示)。

Codex

codex plugin marketplace add hiyeshu/codeck --ref main
codex plugin add codeck@codeck-github

インストール後は新しいタスクを開いてスキルを読み込み、/codeck と打つ。

その他のエージェント

Cursorその他 40 以上のエージェントに対応。

npx skills add hiyeshu/codeck

ローカル開発 — clone してそのまま編集

リポジトリ自体がマーケットプレイス。プラグインの source はリポジトリルートを指すため、ローカル clone がそのまま編集可能なライブインストールになる。

git clone https://github.com/hiyeshu/codeck && cd codeck
  • Claude Code その場読み込み(即時反映): claude --plugin-dir . —— SKILL.md や engine.css、参照ドキュメントを編集したら /reload-plugins

  • Claude Code マーケットプレイス経由: /plugin marketplace add /path/to/codeck の後 /plugin install codeck@codeck。この方式はプラグインキャッシュへコピーされるため、編集後は /plugin marketplace update codeck と再インストールで更新。

  • Codex: codex plugin marketplace add /path/to/codeck、続けて codex plugin add codeck@codeck-github。編集後は codex plugin marketplace upgrade codeck-github で更新。

  • 万能の逃げ道(どのランタイムでも常にライブ): スキルを clone に直接向ける —— すべての Setup ブロックはこの 3 つの環境変数を最優先で読む。

    export CODECK_SKILL_DIR=/path/to/codeck/skills/codeck
    export CODECK_DESIGN_DIR=/path/to/codeck/skills/codeck-design
    export CODECK_EXPORT_DIR=/path/to/codeck/skills/codeck-export

HTML ファイル

出力は自己完結型の HTML ファイル。ブラウザで開くだけ。サーバーもビルドツールも不要。

キーボードショートカット

キー 操作
Space Enter 次のステップ(フラグメントまたはスライド)
Backspace 前のステップ
Esc オーバービュー
F フルスクリーン
P プレゼンターモード

タッチ:左右スワイプで操作。フローティングツールバーはデスクトップではホバーで表示、モバイルでは常時表示。

プレゼンターモード

P を押すとプレゼンターウィンドウが開く:

  • 現在のスライド — 現在のフラグメントステップの大きなプレビュー
  • 次のプレビュー — 次のフラグメントまたは次のスライド
  • スピーカーノート — スクロール可能、ズーム対応(+ / -
  • タイマー — 初回ナビゲーションで自動開始、クリックで一時停止、ダブルクリックでリセット
  • テーマ切替 — ツールバー・オーバービュー・プレゼンターパネルのライト/ダークを一括切替

プレゼンターウィンドウは BroadcastChannel でメインウィンドウと同期。どちらからでも操作可能。

オーバービューモード

Esc で全スライドのサムネイルグリッドを表示。クリックでジャンプ。

License

MIT