teach-impeccable

概要

teach-impeccable とは？

teach-impeccable は、ブランド資産、デザイントークン、UXの好みなど、プロジェクトのデザインコンテキストをキャプチャして保存するUIデザインスキルです。一度実行するだけで、チームや将来のセッションで一貫したインターフェースの美学とデザイン方針の基盤を作れます。

teach-impeccable を使うべき人は？

このスキルは、明確で持続的なデザインガイドラインを確立したいデザイナー、開発者、プロダクトチームに最適です。新規プロジェクトの開始時、コラボレーターのオンボーディング時、またはデザインシステムの正式化に特に役立ちます。

どんな問題を解決する？

• 早期にビジュアル標準を文書化し、デザインのズレを防止
• ブランド資産やデザイントークンを簡単に参照可能に
• UXやブランドの期待を明確にしてオンボーディングを効率化
• 複数の貢献者間で一貫したUIデザインをサポート

使い方

インストール手順

1. 以下のコマンドで teach-impeccable をインストールします：

   npx skills add https://github.com/pbakaus/impeccable --skill teach-impeccable
   

2. SKILL.md ファイルを確認し、ステップバイステップのガイドに従ってください。

初期セットアップの流れ

• コードベースを調査：README.md、package.json、デザインライブラリ、既存コンポーネントをチェックし、現在のデザインパターンや資産を把握します。
• ブランド資産の特定：ロゴ、カラーパレット、スタイルガイドを見つけます。
• デザイントークンの記録：CSS変数、フォントスタック、間隔スケールをメモします。
• 不明点の明確化：ユーザー、ブランドの個性、美的嗜好について具体的なUX質問を行います。

デザインコンテキストの保存

teach-impeccable はデザインコンテキストをAI設定ファイルに保存し、将来のすべてのセッションやコラボレーターがアクセスできるようにします。

推奨確認ファイル

• メインのワークフローは SKILL.md から始めてください
• 必要に応じて README.md、AGENTS.md、metadata.json も参照し、補足情報を得られます

よくある質問

teach-impeccable はすべてのプロジェクトに適していますか？

teach-impeccable はUIの一貫性やデザインシステムの明確化が重要なプロジェクトに最適です。デザイン要件が少ない、または持続的なガイドラインが不要な場合は必ずしも必要ではありません。

ワークフローのカスタマイズは可能ですか？

はい。teach-impeccable のワークフローはリポジトリ構成やツール、チームのニーズに合わせて柔軟に調整できます。デザインコンテキストの収集と文書化のための柔軟な枠組みを提供します。

補助ファイルやスクリプトはどこで見られますか？

リポジトリのFilesタブを開くと、ファイルツリー全体やネストされた参照、補助スクリプトを含む詳細なコンテキストを確認できます。

teach-impeccable はどのくらいの頻度で実行すべきですか？

プロジェクトセットアップ時に一度実行し、主要なデザイン変更があった場合や新しいコラボレーターが参加した際に再度実行してください。