Communitygithub.com

AradhanaID/agent-skills

フロントエンドファイルをリポジトリ内の適切な場所に配置するスキルです。新しいファイルを作成したり、移動する際に使用します。

agent-skills とは?

このスキルは、フロントエンドコードの配置場所を決定するためのルールベースのガイドです。コンポーネント、フック、ユーティリティ、テスト、アセット、設定ファイルなど、ファイルの種類に基づいて最適な配置場所を特定します。ファイルを単体で移動するのではなく、テストやストーリー、スタイルを含む単位全体で移動することを推奨し、命名規則の一貫性も確認します。主にClaude CodeやCursorなどのAIエージェントが、フロントエンドプロジェクトのファイル整理を自動化・標準化するために使用します。また、曖昧なルールや競合が発生した場合は報告し、ルール自体の改善を促す仕組みも備えています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/structure

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

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

ドキュメント

構造

このスキルは、フロントエンドコードの配置場所(フォルダ規約、命名、ファイルの誤配置を判断する基準)を方向づけます。規約はコードベースとともに移り変わるため、信頼できる一覧は reference.md にあります。ファイルを配置する前に必ず参照してください。

手順

  1. ファイルの種類を尋ねる。配置場所ではない。 コンポーネント、フック、ユーティリティ、テスト、アセット、設定。種類によって配置場所が決まります。種類は reference.md の規約における先頭語となります。 完了条件: 種類が一言で述べられていること。
  2. ルールに従って、単位ごとにまとめて配置する。 コンポーネントは、そのテスト、ストーリー、スタイルと一緒に移動します。コンポーネント単体では移動しません。 完了条件: 配置がルールに忠実に一致していること。命名を曲げた箇所は、実行の最後に理由とともに列挙されていること。
  3. 隣接ファイルとの命名を確認する。 名前が兄弟ファイルおよび全体の規約(単数/複数、ピリオド区切り、大文字小文字)と一致していることを確認します。 完了条件: ディレクトリ一覧が統一されて見えること。馴染むために名前を変更する必要がないこと。

リファレンス

  • reference.md — 配置ルールと命名規約。リポジトリのレイアウトが落ち着いたら更新してください。これが唯一の信頼できる情報源であり、他の場所に記載された規約はこのファイルの近似です。
  • 2つのルールが競合するように見える場合、より具体的なルールが優先され、競合は報告されるため、ルールを修正できます。

Individual skills in this repo

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

関連スキル