Communitygithub.com

SamuelChien/mega-skills-collection

ユーザーが「AGENTS.mdを作成」「AGENTS.mdを更新」「エージェント用ドキュメントを管理」「CLAUDE.mdを設定」などと依頼した場合、またはエージェントの指示を簡潔に保つ必要がある場合に使用します。研究に基づいたベストプラクティスに従い、最小限で高シグナルなエージェント用ドキュメントを生成します。

mega-skills-collection とは?

このスキルは、プロジェクトのルートに`AGENTS.md`(およびそのシンボリックリンク`CLAUDE.md`)を作成・管理するためのものです。エージェント向けドキュメントは60行未満、最大でも100行に抑え、ヘッダーと箇条書きのみで構成し、段落や冗長な説明を排除します。パッケージマネージャ、ファイルスコープのコマンド、コミット帰属、主要な規約の4セクションを必須とし、プロジェクト固有のパターンは必要に応じて追加します。ESLintやBiomeなどのリンター設定を重複して記載しない、プロジェクト全体のビルドコマンドではなくファイル単位のコマンドを優先する、といったアンチパターンも明示しています。Claude Code、Cursor、CodexなどのAIエージェントが効率よくプロジェクトに貢献できるよう、高シグナルでノイズのないドキュメントを維持するのに役立ちます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agents-md

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

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

ドキュメント

AGENTS.md の管理

AGENTS.md はエージェント向けの正規ドキュメントです。最小限に保ってください。エージェントは有能であり、過剰な指示は不要です。目標は60行未満、最大でも100行を超えないようにしてください。ドキュメントが長くなるほど、指示に従う品質は低下します。

使用するタイミング

  • ユーザーが AGENTS.md または CLAUDE.md の作成、更新、監査を依頼した場合。
  • プロジェクトに、実際のツールチェーンやリポジトリ構成に基づいた、簡潔で高シグナルなエージェント指示が必要な場合。
  • 既存のエージェント用ドキュメントが長すぎたり、重複があったり、実際のプロジェクトの慣習から乖離している場合。

ファイルのセットアップ

  1. プロジェクトルートに AGENTS.md を作成
  2. シンボリックリンクを作成: ln -s AGENTS.md CLAUDE.md

記述前の分析

ファイルに何を含めるべきか、プロジェクトを分析します:

  1. パッケージマネージャ — ロックファイルを確認 (pnpm-lock.yaml, yarn.lock, package-lock.json, uv.lock, poetry.lock)
  2. リンター/フォーマッター設定 — .eslintrc, biome.json, ruff.toml, .prettierrc などを確認 (これらを AGENTS.md に重複して書かない)
  3. CI/ビルドコマンド — Makefile, package.json のスクリプト, CI設定から正規のコマンドを確認
  4. モノレポの兆候 — pnpm-workspace.yaml, nx.json, Cargo ワークスペース, サブディレクトリの package.json を確認
  5. 既存の慣習 — 既存の CONTRIBUTING.md, docs/, README のパターンを確認

記述ルール

  • ヘッダー + 箇条書き — 段落は使わない
  • コードブロック — コマンドやテンプレートに使用
  • 参照、埋め込みはしない — 既存のドキュメントを参照: 「セットアップは CONTRIBUTING.md を参照」や「src/api/routes/ のパターンに従う」
  • 無駄な記述をしない — 導入、結論、挨拶は不要
  • 能力を信頼する — 自明なコンテキストは省略
  • ファイルスコープのコマンドを優先 — プロジェクト全体のビルドよりも、ファイル単位のテスト/リンター/型チェックコマンドを優先
  • リンターを重複させない — コードスタイルはリンター設定に任せ、AGENTS.md には書かない

必須セクション

パッケージマネージャ

どのツールを使うかと、主要なコマンドのみ:

## パッケージマネージャ
**pnpm** を使用: `pnpm install`, `pnpm dev`, `pnpm test`

ファイルスコープのコマンド

ファイル単位のコマンドは、プロジェクト全体のビルドよりも高速で低コストです。利用可能な場合は必ず含めてください:

## ファイルスコープのコマンド
| タスク | コマンド |
|--------|----------|
| 型チェック | `pnpm tsc --noEmit path/to/file.ts` |
| リンター | `pnpm eslint path/to/file.ts` |
| テスト | `pnpm jest path/to/file.test.ts` |

コミット帰属

このセクションは必ず含めてください。エージェントは自身の ID を使用すべきです:

## コミット帰属
AI コミットには以下を含めること:

Co-Authored-By: (エージェントモデル名と帰属クレジット)

例: `Co-Authored-By: Claude Sonnet 4 <[email protected]>`

主要な規約

エージェントが従うべきプロジェクト固有のパターン。簡潔に保つ。

オプションセクション

本当に必要な場合のみ追加:

  • API ルートのパターン (説明ではなくテンプレートを示す)
  • CLI コマンド (表形式)
  • ファイル命名規則
  • プロジェクト構造のヒント (重要なファイルを指摘し、避けるべきレガシーコードを明示)
  • モノレポの上書き (サブディレクトリの AGENTS.md がルートを上書き)

アンチパターン

以下は省略:

  • 「ようこそ...」や「このドキュメントは...を説明します」
  • 「あなたは...すべき」や「覚えておいて...」
  • 設定ファイル (eslintrc, biome.json, ruff.toml) に既にあるリンター/フォーマッターのルール
  • インストール済みのスキルやプラグインの一覧 (エージェントはこれらを自動的に検出します)
  • プロジェクト全体のビルドコマンド (ファイルスコープの代替がある場合)
  • 明らかな指示 (「テストを実行」「きれいなコードを書く」)
  • 「なぜ」の説明 (「何を」だけ書く)
  • 長い散文の段落

構造例

# エージェント指示

## パッケージマネージャ
**pnpm** を使用: `pnpm install`, `pnpm dev`

## コミット帰属
AI コミットには以下を含めること:

Co-Authored-By: (エージェントモデル名と帰属クレジット)


## ファイルスコープのコマンド
| タスク | コマンド |
|--------|----------|
| 型チェック | `pnpm tsc --noEmit path/to/file.ts` |
| リンター | `pnpm eslint path/to/file.ts` |
| テスト | `pnpm jest path/to/file.test.ts` |

## API ルート
[テンプレートコードブロック]

## CLI
| コマンド | 説明 |
|---------|------|
| `pnpm cli sync` | データを同期 |

制限事項

  • このスキルは、上記で説明したタスクに明確に一致する場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全性の境界、成功基準が不足している場合は、停止して明確化を求めてください。

Individual skills in this repo

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

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

関連スキル