yktsnet
UserA two-phase development lifecycle for AI-agent collaboration: spec-driven bootstrap, guarantee-driven maintenance — on Nix.
Categories
Indexed Skills (25)
app-demo-gif
ブラウザ UI アプリの README 用デモ GIF を Playwright（nix 経由）で録画・生成する。Web アプリの画面デモ・操作 GIF を作りたいとき、README にアプリの動きを載せたいときに使用する。ターミナル CLI のデモは VHS（.tape）の管轄であり本スキルは使わない。
vhs-demo
ターミナル CLI の README 用デモ GIF を VHS（.tape）で設計・生成する。CLI モジュールのデモ GIF を作る・作り直すとき、demo.tape を書くときに使用する。ブラウザ UI のデモは app-demo-gif の管轄であり本スキルは使わない。
repo-readme
公開前にリポの README を readme-guide に従って作成・更新する。中身が固まった段階で実行する。Tech Stack の選定理由・Design Decisions・JUDGE.md/PLAN.md 統合（統合���は削除）・docs/ 分離・構成図まで含む本格 README を書きたいときに使う。
repo-standardize
新規リポの組成、または既存リポの公開前点検を docs-agents の4基準で行う。リポを初期化・標準化・点検したいとき、新規ディレクトリを作って足場を整えたいときに使う。
cf-private-deploy
個人用 Web アプリを Cloudflare Pages に載せ、Cloudflare Access（Google ログイン限定）で自分だけに閉じた状態で公開する。トークン発行以外は全て REST API で行い、ダッシュボードの GUI 操作を排する。アプリを初めて配信するとき、Access で保護するとき、pages.dev の穴を塞ぐときに使う。
ctx-history-search
過去の相談者セッション（直前の続きを読む・設計判断や議論の経緯を確認する・直近/今日何を作業したかの振り返り）を ctx で検索する。対象は運用しているリポのうち相談者セッションが動くものすべて。「さっきの続きをやりたい」「これ前に決めたはず」「今日/直近何をしたか」を確認したいときに使う。git log は commit された変更点しか分からないので、議論の経緯や作業内容の粒度が要る要約はこちらを優先する。
mermaid-diagram
GitHub 上でレンダリングされる Mermaid 図を diagram-guide に従って新規作成・監査・修正する。README の構成図・技術記事の図・解説ドキュメントの図を描きたいとき、既存の図が横に長くて読みにくい・何を図にすべきか決まらないときに使う。図を SVG に焼かず ```mermaid フェンスのまま扱う。
repo-publish
Private リポを Public 化する。全履歴のシークレットスキャン → 公開 → 公開時にしかできない設定（ruleset・auto-merge）までを一括で行う。公開したいとき、gh repo edit --visibility を打ちたくなったときに必ず使用する。
session-nudge
別の稼働中セッションについて相談したいときに使う。対象セッションを選んで相談したいことを伝えると、その履歴を読んで外から客観視し、簡単に答える。相談の結果、対象セッションへ送ることになったら人間の裁可を経て SendMessage で送る。tmux M-m のポップアップ端末から呼び出す想定。
sops-secrets
sops / age による secret の暗号化・復号・追加・再暗号化の運用手順。secret を暗号化する・inject する・`secrets/` 配下を触る・`.sops.yaml` や `devices/secrets.nix` を変更する・新デバイスの鍵を登録するとき、および sops 関連エラー（cannot parse dotenv / unexpected end of JSON input 等）の対処時に必ず使用する。
jp-writing-code
ソースコード内（.astro, .html, .vue, .tsx 等）���日本語テキストを jp-writing の規範で修正する。対話でファイルを選び、日本語部分のみを対象にする。
readme-i18n
既存の日本語 README.md から英語版 README.en.md を生成・同期し、両ファイルの冒頭に言語切り替えリンクを挿入する。
comment-cleanup
Claude Codeが書いた冗長なコメント（WHATを説明するだけの長文・箇条書き・日記のような日付入り履歴）を検出し、削除または圧縮する。「コメントを綺麗にして」「長いコメントを整理して」と頼まれたとき、または特定リポのコメント肥大が気になったときに使う。行数の機械的な強制はしない。
hunk-comments
稼働中の Hunk に user が行単位で残したレビューコメントを取り込んで対応する。「hunk にコメントした」「コメント見て」「指摘を書いたので直して」と言われたときに使う。別ペインで hunk diff --watch が開いたままであることが前提。
pr-workflow
Issueファイルに基づく実装からローカルコミットまでの標準フロー。push・PR作成はしない（issue-finish が行う）
guarantee-audit
既存テストから公開面の保証を抽出し、保証台帳 docs/guarantees.md のドラフトを書き出して user の裁可を受け、裁可済みの欠落テストをその場で追加し、台帳を正式運用へ格上げする。テストを持つリポに台帳を初めて��くとき、または台帳とテストの乖離を疑うときに使う。
jp-writing
日本語の文章規範。README・技術記事・Zenn・リポ内解説など、日本語で Markdown や文書を新規に書くとき、または既存文書をリライト・推敲するときは必ず適用する。冗長の排除、LLM口調・翻訳調の禁止、型の反復禁止、視点と語りの一貫性、リライト時の一律適用の禁止を定める。
consolidate-rules
CLAUDE.md群・docs-agents・自作Skill（frontmatter descriptionが日本語のもののみ、ベンダー技術リファレンス系・Anthropic標準搭載Skillは対象外）の間で規則が矛盾・陳腐化していないかを、索引ファイル `~/dotfiles/.claude/RULES.md` を起点に棚卸しし、指摘ごとにuserの裁可を得てから該当ファイルを直接編集する。索引は棚卸しのたびに更新し、2回目以降は前回からの変更差分だけを深読みする。定期実行（schedule/loop）を前提にした設計。規則ファイルが増えて整合性が怪しくなったと感じたとき、CLAUDE.mdとdocs-agentsの記載がずれていないか確認したいときに使う。プロダクトコードは書かない。
dependabot-triage
溜まった Dependabot PR（主に major）を横断棚卸しし、github-actions major(CI green)はその場でマージまで実行する。「溜まってる PR 見て」「Dependabot 棚卸しして」と頼まれたときに使う。対象リポは固定リストを保守せず、dotfiles / github-public / github-private 配下を毎回動的に探索する。判断基準の正本は `docs-agents/cicd-guide.md` §6。
new-issue
相談者としてIssueファイルを設計し issues/ に書き出す。開放チャットで実装を頼まれたとき、またはIssueを立てたいときに使う。コードは書かない（軽量経路の条件を満たす場合を除く）。
repo-about
README（英語版優先）から GitHub リポの About (description) と topics を生成し、gh repo edit で設定する。
netboot-stateless
NixOS のディスクレス機を netboot（PXE / pixiecore）で配信・起動する運用手順。無状態（tmpfs root）デバイスを追加・再配信・ビルドするとき、initrd の肥大化やカーネルパニック等の netboot 系エラーを対処するときに使用する。
nix-tool-install
新しい CLI ツール・パッケージをインストールしたくなったときの手順。brew install / npm -g / pip install --user 等を打つ前に必ず使用する。全デバイスが Nix 管理（nix-darwin / NixOS + home-manager）であり、Nix 外のパッケージマネージャでのインストールは禁止。
skill-dev
新しい Claude Code skill を作る・追加する・整備したくなったときの配置ルール。「スキルを作って」「これをスキルにして」「skillを追加したい」等、SKILL.md を新規に書こうとする前に必ず使用する。どこに置くか（dotfiles管理のグローバル vs リポ固有）を先に決める。
module-dev
OSS モジュール型リポ（ポートフォリオ兼実用）の設計標準。新しいモジュールリポを始めるとき、既存リポにモジュールを追加するとき、配布形態（レジストリ / clone）やデモ方式を決めるときに使用する。
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.