本文へ移動
cccskills
無料GitHub で公開

agents-md-creator

AIコーディングエージェント向けの指示書「AGENTS.md」を作成するスキル。プロジェクトにAIエージェントが作業するための文脈と指示を集約するファイルを作成したい場合に使用します。「AGENTS.mdを作成」「AIエージェント用の指示書を作る」「エージェント向けREADMEを作成」などのリクエストでトリガーします。

OpenAI Codex、Claude Code、GitHub Copilot、Cursorなど、複数のAIエージェントで共通利用できるオープンな標準フォーマットです。

インストール方法を見る

含まれるファイル(2)

  • SKILL.md7.1 KB
  • metadata.json1.8 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

AGENTS.md クリエイター

このスキルは、AI コーディングエージェント向けの指示書「AGENTS.md」の作成をサポートします。

AGENTS.md について

AGENTS.md は、AI エージェント専用の「エージェント用 README」として機能するファイルです。人間向けの README.md とは別に、AI がプロジェクトを理解し、適切にコードを書いたりテストしたりするために必要な文脈と指示を集約します。

特徴

  • オープンな標準フォーマット: 特定のツールに依存せず、複数の AI エージェントで共通利用可能
  • 階層構造対応: モノレポではサブディレクトリごとに配置でき、最も近いファイルが優先される
  • 自動実行: 記載されたテストコマンドをエージェントが自動実行可能

作成ワークフロー

1. プロジェクト情報の収集

AGENTS.md を作成する前に、以下の情報を収集:

  1. プロジェクト概要: プロジェクトの目的や全体像
  2. 技術スタック: 使用言語、フレームワーク、主要ライブラリ
  3. 既存のドキュメント: README.md、package.json、設定ファイルなどを確認

2. セクション構成の決定

プロジェクトの性質に応じて、以下から必要なセクションを選択:

セクション説明優先度
プロジェクト概要目的と全体像高
セットアップ・ビルドコマンド依存関係のインストール、開発サーバー起動高
テスト手順テスト実行方法、フォーカス方法高
コードスタイル・規約言語設定、フォーマット規則、関数パターン中
PR・コミット規定PR タイトル形式、コミット前チェック中
環境固有のチップスディレクトリ構造、パッケージ管理のコツ低
セキュリティ上の注意セキュリティ考慮事項必要時

3. AGENTS.md の作成

基本構造

# AGENTS.md

## プロジェクト概要

[プロジェクトの目的と全体像を簡潔に記述]

## セットアップ

[依存関係のインストール方法]
[開発サーバーの起動方法]

## ビルド

[ビルドコマンドと手順]

## テスト

[テストの実行方法]
[特定のテストへのフォーカス方法]

## コードスタイル

[使用する言語設定]
[フォーマット規則]
[命名規則]

## PR・コミット規定

[PR タイトルの形式]
[コミット前に行うべきチェック]

## ディレクトリ構造

[重要なディレクトリの説明]

## 注意事項

[セキュリティ上の注意]
[その他の重要な考慮事項]

4. 保存先の決定

  • 単一プロジェクト: リポジトリルートに AGENTS.md を配置
  • モノレポ: サブディレクトリごとに配置可能(AI は最も近いファイルを優先)

執筆ガイドライン

記述のポイント

  1. 具体的なコマンドを記載: AI が直接実行できる形式で

    ✓ pnpm install && pnpm dev
    ✗ 依存関係をインストールしてください
    
  2. 新しいチームメイトに伝えるべきこと: 暗黙知を明文化する

    • 「README には書いていないけど、このプロジェクトでは...」
    • 「テスト前には必ず...」
  3. 人間用ドキュメントとの分離: ビルド手順の詳細など、人間には冗長な情報は AGENTS.md へ

避けるべきこと

  • 一般的な知識の繰り返し(AI が既に知っていること)
  • 曖昧な指示(「適切に対応」ではなく具体的に)
  • 古い情報の放置(定期的に更新を推奨)

プロジェクトタイプ別テンプレート

Node.js/TypeScript プロジェクト

# AGENTS.md

## プロジェクト概要

[プロジェクトの説明]

## セットアップ

pnpm install

## 開発サーバー

pnpm dev

## ビルド

pnpm build

## テスト

pnpm test

# 特定のテストを実行

pnpm test -- --grep "test name"

## コードスタイル

- TypeScript strict mode 使用
- セミコロンなし
- シングルクォート使用
- インデント: 2 スペース

## リント

pnpm lint
pnpm lint:fix

## PR 規定

- タイトル形式: `[type]: description`
- コミット前に `pnpm lint && pnpm test` を実行

Python プロジェクト

# AGENTS.md

## プロジェクト概要

[プロジェクトの説明]

## セットアップ

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

## テスト

pytest

# 特定のテストを実行

pytest tests/test_module.py -k "test_name"

## コードスタイル

- Python 3.10+
- Black でフォーマット
- isort でインポート整理
- mypy で型チェック

## リント

black .
isort .
mypy src/

## PR 規定

- コミット前に `black . && isort . && pytest` を実行

Go プロジェクト

# AGENTS.md

## プロジェクト概要

[プロジェクトの説明]

## セットアップ

go mod download

## ビルド

go build ./...

## テスト

go test ./...

# 特定のテストを実行

go test ./... -run TestName

## コードスタイル

- gofmt でフォーマット
- golint でリント
- Go 1.21+

## リント

go fmt ./...
golint ./...
go vet ./...

インタラクティブな作成プロセス

すべての情報が最初から提供されていない場合は、ユーザーに質問して情報を収集します。

推奨される質問順序

  1. 「このプロジェクトはどのような技術スタック(言語、フレームワーク)を使用していますか?」
  2. 「ビルドやテストにはどのようなコマンドを使用しますか?」
  3. 「コーディング規約やスタイルガイドはありますか?」
  4. 「PR やコミットに関する規定はありますか?」
  5. 「AI エージェントが作業する際に知っておくべき特別な注意点はありますか?」

一度に多くの質問をせず、最も重要な情報から段階的に収集してください。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

[00] TnR ABSOLUTE RIGOR — Systemic Verification Doctrine. Forced cognitive exertion for high-stakes investigations. Mandates absolute deconstruction, mathematical proof chains, and ≥95% derived certainty. Zero-tolerance for heuristics or sentiment-based reasoning. Shortcuts are defined as intentional hallucinations.

日本語の概要は準備中です。原文の説明を表示しています。

diegosouzapw/awesome-omni-skill622026年3月2日 更新

2agent

無料日本語概要

Configures 2-Agent workflow between PM and implementation roles. Use when user mentions 2-Agent, 2エージェント, PM連携設定, Cursor設定, Cursor連携, 2-agent運用. Do NOT load for: 単独運用, ワークフロー実行, ハンドオフ処理.

diegosouzapw/awesome-omni-skill622026年3月2日 更新

Appends relevant hashtags to journal entries based on content analysis. Intended for LLM execution.

日本語の概要は準備中です。原文の説明を表示しています。

diegosouzapw/awesome-omni-skill622026年3月2日 更新

add-agent

無料

Add a new AI coding agent to Agent Sandbox. Creates all required files (Dockerfile, templates, CI, docs) and wires the agent into the CLI, proxy, and build system.

日本語の概要は準備中です。原文の説明を表示しています。

diegosouzapw/awesome-omni-skill622026年3月2日 更新

Add a new property to the AI agents database. Use when the user wants to add, create, or introduce a new column, property, field, or feature to track across all agents in the comparison matrix. Handles all four required steps - database updates, groups.json, table display, and GitHub issue templates.

日本語の概要は準備中です。原文の説明を表示しています。

diegosouzapw/awesome-omni-skill622026年3月2日 更新

Add new Agent templates to the meta-agent-skills framework.

日本語の概要は準備中です。原文の説明を表示しています。

diegosouzapw/awesome-omni-skill622026年3月2日 更新

diegosouzapw のスキルをすべて見る

このスキルの問題を報告する