Community研究&データ分析github.com

iamk3nnyt/claude-skills

フィーチャーのアイデアを1ページの仕様書に変換します。問題、対象ユーザー、MVPの範囲、非目標、番号付きのGiven/When/Then受け入れ基準、影響を受けるルート、データ、メール、未解決の質問をカバーします。「brief」「spec this」「scope this」「what would it take」などのユーザー発言時、または範囲が不明確なフィーチャーを開始する前に使用します。

claude-skills とは?

このスキルは、AIエージェント(Claude Codeなど)がフィーチャーのアイデアを構造化された1ページの仕様書(brief)に変換するためのガイドです。ユーザーが「brief」「spec this」「scope this」などと言ったとき、または範囲が不明確なフィーチャーに取り組む前に使用します。仕様書には、問題、ターゲットユーザー、MVPのスコープ、非目標、番号付きのGiven/When/Then形式の受け入れ基準、影響を受けるルート・テーブル・メール・環境変数、リスク、そして未解決の質問が含まれます。このスキルは、あいまいなアイデアをチームがすぐに着手できる明確な設計文書に変換することで、開発の手戻りを減らします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/brief

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

ドキュメント

ブリーフ

フィーチャー: $ARGUMENTS

まずは基礎を固める(黙って)

  • リポジトリのCLAUDE.mdと、このプロジェクトのメモリエントリを読み込む。フィーチャーが触れるルート、スキーマ、メールテンプレートをざっと確認する。仕様書は実際のファイルパスと既存のフィールドを引用する。
  • 決定がスコープを変更する場合にのみインタビューを行う。一度に1つの質問を、推奨オプション付きでAskUserQuestionを使用して行い、最大3つの質問に抑える。それ以外はすべて未解決の質問に仮定として記載する。

スコープに関するルール

  • MVPとは、既存のフィールドとコンポーネントを使用して構築される従来の最小限のものを意味する。「どんなeコマースでも」とは標準的なフローを指し、プラットフォームを意味しない。
  • 依頼されていないコンポーネント、設定、管理画面、分析は決して追加しない。代わりに非目標としてリストアップする。
  • パートナーまたはAPI機能:「APIキー」は通常、開発者ポータルではなく、env内のテナントIDを意味する。
  • CLAUDE.md/メモリからのプロジェクト制約を尊重する(例:「スキーマ変更禁止」)。それを破るものはすべてフラグを立てる。

テンプレート

# <フィーチャー>: ブリーフ
**問題:** 1~2文で、ユーザーの課題を記述。解決策ではない。
**対象:** 誰に向けてか、および既知であればその数(出典を引用)。
**MVP:** 3~6個の箇条書き。それぞれリリース可能で観測可能であること。
**非目標:** 今回明示的にやらないこと。
**受け入れ基準**
1. Given <状態>, When <アクション>, Then <観測可能な結果>.
2. … (それぞれフローチェック、スモークテスト、または単体テストで検証可能であること)
**影響箇所:** ルート · テーブル/フィールド(既存優先) · メール · env/シークレット · サードパーティ
**リスク:** 金銭、法的/GDPR、配信到達性、SEO(noindex/正規URL)、i18n
**未解決の質問:** 番号付き。それぞれに、未回答の場合のデフォルトを記載

出力

  • デフォルトはチャットに表示。docs/briefs/<slug>.md への書き込みは要求された場合のみ。
  • 一文のリード文(「以下がブリーフです: N個の基準、M個の未解決の質問」)に続けてブリーフを表示。その後には何も書かない。

終了条件

  • すべての受け入れ基準が観測可能であり、チェック(フローチェックのステップ、スモークの期待値、またはテスト)に対応していること。
  • MVPに、依頼されていないもの、または依頼されたものに厳密に必要でないものが含まれていないこと。
  • 未解決の質問にはそれぞれデフォルトがあり、待たずに構築を開始できること。

Individual skills in this repo

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

iamk3nnyt/claude-skills

Checks UI copy across locales by comparing key parity between next-intl message catalogs and in-code sv/en COPY objects, finding placeholder and array mismatches and words from the other language leaking in (the "och" in English bug), then manually reviewing claims against terms and pricing and the project's banned phrases. Use after editing copy or translations, before shipping a page with new text, or when asked to proofread or check translations.

iamk3nnyt/claude-skills

Applies an agreed visual direction to a page or component by reusing existing components first, then verifies every width and dark mode with the headless-Chrome audit plus a before/after pixel diff, and reviews against Refactoring UI, Nielsen and WCAG 2.2. Use when asked to redesign, restyle, polish or "make it look like the reference", after design-ref or when the direction is already clear.

iamk3nnyt/claude-skills

Extracts the visual system from a reference site or pasted HTML (colour roles, type scale, spacing scale, radii, shadows, button/card/eyebrow anatomy, tone) and maps it onto the current project's existing tokens as a short token table. Use when the user shares a reference ("make it look like <site>", "in this style", a URL or HTML paste) before a redesign.

iamk3nnyt/claude-skills

QAs a project's transactional and digest emails by rendering every template without DB or network, screenshotting at 600 and 375 px in light, dark and images-off, and checking for placeholder leaks (undefined, NaN, {{…}}), preheader, unsubscribe, alt text, absolute links, Outlook-safe buttons, viewport meta and Gmail's 102 KB clip. Use when email templates change, before sending a campaign, or when asked to check how emails look.

関連スキル