teach-impeccable

概要

teach-impeccableは、プロジェクトのデザインコンテキストとガイドラインをAI設定ファイルに記録・保存し、持続的に管理するためのUIデザインスキルです。一度のセットアップで、デザイン基準を明確に定義し、チームやAIエージェントが一貫して参照できるようにします。統一されたUIデザイン言語を確立・維持したいプロジェクトに特に役立ちます。

teach-impeccableでできること

• コードベースやドキュメントから重要なデザインコンテキストを収集
• UXやブランドに関する質問で不足部分を補完
• 得られたガイドラインをAI設定に保存し、将来にわたり参照可能に

このスキルを使うべき人

• UI/UXデザイナー、フロントエンド開発者、プロジェクト管理者
• 新規プロジェクトを始めるチームやデザイン基準を正式化したいチーム
• AI支援のワークフローでデザインの一貫性を確保したい方

teach-impeccableが解決する課題

• UIデザインの判断における曖昧さを軽減
• すべての関係者やAIツールがデザインコンテキストにアクセス可能に
• ガイドラインを持続的に保存し、デザインのズレを防止

使い方

インストール手順

1. 以下のコマンドでプロジェクトにスキルを追加します：

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

2. SKILL.mdファイルを確認し、ガイド付きワークフローとチェックリストを参照してください。

初期セットアップの流れ

• コードベースやドキュメント（README.md、package.json、スタイルガイド、ブランド資産など）を調査し、既存のデザインコンテキストを収集します。
• スキルの質問に答えながら、ユーザーのニーズ、ブランドの個性、デザインの好みを明確にします。
• 指示に従い、AI設定ファイルに調査結果や回答を記録します。

ベストプラクティス

• デザイナーと開発者の両方をセットアップに参加させ、包括的な内容にすること
• プロジェクトの進展に応じてデザインコンテキストを見直し、更新すること

teach-impeccableが適しているケース

• 新しいUIプロジェクトの開始時や新メンバーのオンボーディング時
• デザインガイドラインを正式化・更新したい場合
• 持続的なデザインコンテキストを活用するAIエージェントを使うプロジェクト

適さない場合

• UIやデザイン要件がないプロジェクト
• すでに強固で運用されているデザインシステムと設定がある場合

よくある質問

メインのワークフローやチェックリストはどこにありますか？

スキルディレクトリ内のSKILL.mdファイルにステップバイステップのガイドがあります。

まずどのファイルを確認すればいいですか？

SKILL.mdから始め、その後README.md、AGENTS.md、metadata.json、およびrules/やresources/などの補助フォルダを確認して追加情報を得てください。

teach-impeccableはデザインの決定を強制しますか？

いいえ、ガイドラインの記録と持続を支援しますが、自動的に強制することはありません。

デザインコンテキストは後から更新できますか？

はい、ワークフローを再実行するか、AI設定ファイルを手動で更新してプロジェクトの変化に対応できます。

関連ファイルはどこで確認できますか？

リポジトリのFilesタブを開くと、参照ファイルや補助スクリプトを含む全ファイルツリーを閲覧できます。