Communitygithub.com

Varnan-Tech/opendirectory

任意のウェブサイトに対して、標準準拠の llms.txt ファイルを生成・維持します。ライブサイトのクロール、またはウェブサイトのコードベースを直接読み取ることで動作します。

opendirectory とは?

このスキルは、AIエージェント向けの標準化されたサイト情報ファイル `llms.txt` を生成・管理するためのツールです。ユーザーが llms.txt の作成、AIによるサイトの可読性向上、Generative Engine Optimization (GEO)、AIレディネスの監査を依頼した際に自動的にトリガーされます。スキルは2つのモードで動作します。**コードベースモード**では、ユーザーのプロジェクト内の設定ファイルやページファイルを直接解析し、フレームワーク(Next.js、Astro、Nuxt など)やルート情報を抽出します。**ライブサイトモード**では、Chrome DevTools MCP サーバーを使用して実際のサイトをクロールし、各ページのコンテンツを取得します。どちらのモードでも、取得した実際のデータのみを使用して、厳密にフォーマットされた `llms.txt` ファイルと、必要に応じて全コンテンツを含む `llms-full.txt` ファイルを生成します。生成後は、フレームワークに応じた適切な場所(例:Next.js の `public/` ディレクトリ)にファイルを保存し、ユーザーに確認を促します。このスキルにより、開発者は手作業なしにサイトのAI可読性を向上させ、生成AI検索での可視性を高めることができます。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Varnan-Tech/opendirectory/tree/main/skills/llms-txt-generator

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

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

ドキュメント

llms.txt ジェネレーター

あなたは Generative Engine Optimization (GEO) と llms.txt 標準の専門家です。ウェブサイトをクロールし、AIエージェントがサイトを完全に読み取り、引用できるように、完璧に構造化された llms.txt ファイルを生成するのがあなたの役割です。

重要ルール: コンテンツを捏造しないこと。 すべてのリンク、タイトル、説明は、クロール中に実際にサイトで見つけたものから取得しなければなりません。訪問していないコンテンツのURLを作成したり、説明を書いたりしてはいけません。

必須セットアップ確認: 開始前に、以下が整っていることを確認してください。

  • Chrome がリモートデバッグを有効にして実行中であること (chrome --remote-debugging-port=9222)
  • Chrome DevTools MCP サーバーがエージェント設定に構成されていること
  • ユーザーからターゲットのウェブサイトURLが提供されていること

Chrome が利用できない場合は、標準のウェブフェッチツールにフォールバックしてページコンテンツを取得してください。どちらも利用できない場合は、処理を停止し、ユーザーに Chrome アクセスまたは生のページコンテンツの提供を依頼してください。


ワークフロー

ステップ 1: ソースの検出 — コードベースかライブサイトか?

他のすべてを始める前に、現在ウェブサイトのコードベース内にいるかどうかを確認します。

  1. 現在のワーキングディレクトリまたはその親ディレクトリに、package.json、astro.config.*、next.config.*、nuxt.config.*、gatsby-config.*、vite.config.*、または _config.yml があるか確認します。
  2. 見つかった場合 → コードベースモード (ステップ 2A へ進む)。
  3. 見つからなかった場合 → ユーザーにターゲットURLを尋ね、ステップ 2B へ進みます。

ステップ 2A: コードベースモード — リポジトリを直接読み取る

ソースコードにアクセスできます。コードからすべてを抽出してください。これにより、レンダリング前のコンテンツを取得できるため、クロールよりも優れたカバレッジが得られます。

2A-1. フレームワークとサイト設定の検出:

  • package.json を読む → フレームワーク (next, astro, nuxt, gatsby, @sveltejs/kit など) と name/description フィールドを特定する
  • フレームワーク設定ファイル (next.config.*、astro.config.* など) を読み、basePath、site、siteUrl を確認する
  • public/ または static/ または dist/ に既存の llms.txt がないか確認する — 見つかった場合は読み取る
  • QA: このフレームワークは何ですか?ベースURLは何ですか?llms.txt はすでに存在しますか?

2A-2. すべてのページ/ルートを発見する:

フレームワーク確認場所
Next.js (Pages Router)pages/**/*.tsx、pages/**/*.jsx — _app、_document、api/ はスキップ
Next.js (App Router)app/**/page.tsx、app/**/page.jsx — ディレクトリ名 = ルート
Astrosrc/pages/**/*.astro、src/pages/**/*.md
Nuxtpages/**/*.vue
Gatsbysrc/pages/**/*.tsx、src/pages/**/*.jsx
SvelteKitsrc/routes/**/+page.svelte
Hugo / Jekyllcontent/**/*.md、_posts/**/*.md

各ページファイルを読み取り、以下を抽出します: ページタイトル (<title>、export const metadata、frontmatter title:)、メタ説明、メインヘッディング (H1、H2)。

2A-3. ブログ/コンテンツ記事を見つける:

  • content/、posts/、src/content/、_posts/、blog/ に Markdown/MDX ファイルがないか確認する
  • 各ファイルから frontmatter (title、description、date、slug) を読み取る
  • 最新または最も重要な記事を5~10件リストアップする

2A-4. サイトの既存のSEO/メタ設定を読む:

  • src/config.ts、src/site.config.ts、seo.config.*、または siteTitle、siteDescription、siteUrl をエクスポートするファイル
  • constants.ts、config/index.ts — サイトレベルのメタデータを探す

2A-5. ベースURLを構築する:

  • 設定ファイルの siteUrl または site を優先する
  • フォールバック: ユーザーに尋ねる: 「本番URLは何ですか?(例: https://yoursite.com)」
  • QA: ベースURLは確認されましたか?llms.txt 内のすべてのリンクは完全な絶対URLを使用する必要があります。

その後、ステップ4 にスキップして、コードベースデータを使用してファイルを生成します。


ステップ 2B: ライブサイトモード — ターゲットURLを取得する

ユーザーがURLを提供していない場合は、尋ねます: 「どのウェブサイトの llms.txt を生成しましょうか?」

ステップ 3: 既存の llms.txt を確認する (ライブサイトモードのみ)

クロールする前に、サイトに既存のものがないか確認します:

  1. [URL]/llms.txt に移動する
  2. 存在する場合: 読み取り、内容を確認し、盲目的に置き換えるのではなく、更新/改善する計画を立てる
  3. 存在しない場合: フルクロールに進む
  • QA: 既存のファイルを確認しましたか?そのステータス (未存在 / 古い / 存在し良好) を記録してください。

ステップ 3B: ブラウザに接続してクロールする

Chrome DevTools MCP サーバーを使用してライブブラウザに接続します。chrome-cdp-skill と同じ接続パターンに従います:

  1. Chrome DevTools MCP 経由で http://localhost:9222 に接続する
  2. ホームページに移動する — サイト名、タグライン、メインナビゲーションリンク、主要な価値提案を記録する
  3. 存在する各キーページに移動する (ナビリンクを確認): /docs、/blog、/api、/about、/pricing、/examples、/changelog
  4. 各ページについて: H1、メインコンテンツセクション、サブナビゲーションリンクを読む
  5. ブログについて: 最も関連性が高く最近の5~10件の記事のタイトルと説明を読む

Chrome DevTools MCP が利用できない場合は、標準のウェブツール (curl、fetch) を使用してページを取得するようにフォールバックします。サイトが403を返す場合は、ブラウザのUser-Agentヘッダーを追加してみてください。

  • QA: 各ページの読み込みと読み取りは成功しましたか?訪問したページと404を返したページをリストアップしてください。404ページは含めないでください。

ステップ 4: 仕様とテンプレートを読む

出力を書き始める前に、両方の参照ファイルを読んでください:

  • references/llms-txt-spec.md — フォーマットルールと検証チェックリスト
  • references/output-template.md — 従うべき正確なテンプレート

使用したモードをメモしてください: コードベースモード (データはソースファイルから取得) または ライブサイトモード (データはブラウザクロールから取得)。どちらも同じ出力形式を生成します — 唯一の違いはデータソースです。

ステップ 5: llms.txt を生成する

クロールからのコンテンツのみを使用して、llms.txt ファイルを生成します:

  1. H1 ヘッダーを書く (製品/サイト名 — 事実に基づき、タグラインではない)
  2. サマリーブロッククオートを書く (1~3文、事実に基づき、LLMフレンドリー — マーケティングの誇張は禁止)
  3. 実際にサイトにコンテンツがある H2 セクションのみを追加する
  4. 各リンクについて: LLM がそのURLで見つけるものについて、事実に基づき、内容の濃い説明を書く
  5. 確定前に references/llms-txt-spec.md の検証チェックリストを適用する
  • QA: すべてのURLは実際のクロールから検証されましたか?すべての説明は事実に基づいており、マーケティングコピーではありませんか?ファイルは5,000ワード未満ですか?先に進む前に問題を修正してください。

ステップ 6: llms-full.txt を確認する

ユーザーに尋ねます: 「主要ページの全文散文コンテンツを含む llms-full.txt も生成しますか?これは大きくなりますが、AIエージェントにすべてを1つのファイルで提供します。」

はいの場合: 各キーページに再度アクセスし、各リンクエントリの下に、--- で区切って、完全なクリーンなテキストコンテンツを貼り付けます。

ステップ 7: 保存と出力

  1. llms.txt をカレントワーキングディレクトリ (またはユーザーのプロジェクトルート、既知の場合) に保存する
  2. llms-full.txt が要求された場合は、それも保存する
  3. 会話内に llms.txt の全文を出力し、ユーザーが確認できるようにする
  4. ユーザーのサイトが GitHub 上にある場合は、リポジトリルートにファイルを追加するPRを作成することを提案する
  • QA: ファイルは保存されましたか?保存パスをユーザーに確認しましたか?

ステップ 8: 配置手順

コードベースモードの場合: フレームワークがわかっているので、すぐにファイルを配置します:

フレームワークアクション
Next.js / Vercelリポジトリの public/llms.txt に直接書き込む
Astropublic/llms.txt に直接書き込む
Nuxtpublic/llms.txt に直接書き込む
Gatsbystatic/llms.txt に直接書き込む
SvelteKitstatic/llms.txt に直接書き込む
Hugostatic/llms.txt に直接書き込む
Jekyllリポジトリのルートに llms.txt として直接書き込む

ユーザーに尋ねます: 「llms.txt をリポジトリの public/llms.txt に直接書き込むことができます。今すぐ実行しますか、それとも先に確認しますか?」

承認された場合、ファイルを書き込みます。その後、ユーザーに伝えます: 「サイトをデプロイすると、https://yourdomain.com/llms.txt でファイルが公開されます。」

ライブサイトモードの場合: ユーザーに追加場所を伝えます:

llms.txt をウェブルートに配置して、次の場所でアクセスできるようにします: https://yourdomain.com/llms.txt

- Next.js / Vercel: /public/llms.txt に配置
- Astro / Nuxt / Gatsby / SvelteKit: /public/llms.txt に配置
- GitHub Pages: リポジトリのルートに配置
- Hugo / Jekyll: /static/llms.txt に配置
- WordPress: FTPでウェブルートにアップロードするか、リライトルールを使用
- カスタムサーバー: /llms.txt で静的ファイルとして提供

出力品質基準

優れた llms.txt ファイル:

  • 事実に基づいたH1と、LLMが直接引用できる明確な2~3文のサマリーがある
  • サイトが実際に持つすべての主要コンテンツ領域をカバーしている
  • 「そこに何があるか」を説明するリンク説明を使用しており、企業が思ってほしいことではない
  • 30秒以内にスキャン可能
  • 壊れたリンク、リダイレクトチェーン、CDNアセットURLが含まれていない
  • references/llms-txt-spec.md のすべてのチェックに合格する

悪い llms.txt ファイル:

  • マーケティング用語が含まれている (「私たちの素晴らしいAPI」、「最高クラスのドキュメント」)
  • 捏造または推測されたURLが含まれている
  • サイトの主要セクションが欠落している
  • 空またはあいまいな説明がある (「製品に関する情報」)

Individual skills in this repo

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

Varnan-Tech/opendirectory

Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.

Varnan-Tech/opendirectory

World-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA, then applies scientific naming frameworks (Phonosemantics) and automated multi-TLD domain checking.

Varnan-Tech/opendirectory

Use when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a focused file under 100 lines containing only the non-obvious build commands, conventions, and gotchas Claude Code needs.

Varnan-Tech/opendirectory

Use when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV using ValidEmail.co or the open-source Reacher engine.

Varnan-Tech/opendirectory

Competitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs) with heat scores and AI briefings.

Varnan-Tech/opendirectory

Give it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of them (editorial, podcasts, communities), identifies which channels appear most frequently, looks up the journalist or host for each, and returns a tiered outreach list with story angles and ready-to-send cold pitch drafts tailored to your product. Use when asked to find PR opportunities, discover where competitors got featured, build a media outreach list, find which journalists cover my space, or get pitch templates for press coverage.

Varnan-Tech/opendirectory

Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).

Varnan-Tech/opendirectory

Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says "check for outdated packages", "update my dependencies", "open PRs for dependency updates", "scan for CVEs", or "which packages need upgrading".

Varnan-Tech/opendirectory

Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.

Varnan-Tech/opendirectory

Evaluates expired domain candidates against a target niche, scores them by topical relevance, historical activity level, and history cleanliness, then outputs a ranked shortlist with explainable reasoning and risk flags.

Varnan-Tech/opendirectory

Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README clarity, visual proof, install, quick-start, docs, examples, community, trust, marketing), writes a shareable roast in the requested tone (brutal/honest/kind), produces a prioritized action plan ranked by impact × effort, and sketches an ideal README. Trigger when user says "roast my repo", "audit my README", "dx audit", "developer experience review", "score my GitHub project", "before launch checklist", or "make my repo shareable".

Varnan-Tech/opendirectory

Drafts and designs a complete HTML email newsletter from a topic or content brief. Outputs paste-ready HTML for Loops, Mailchimp, Beehiiv, Resend, or any standard email platform. Includes subject line options and plain-text fallback. Trigger when a user says "write a newsletter", "draft an email newsletter", "create an HTML email", "design an email for my subscribers", or "write a newsletter about [topic]".

Varnan-Tech/opendirectory

Takes a GitHub PR URL or the current branch and writes a plain-English explanation of what it does and why, then posts it as a PR comment. Use when asked to explain a PR, summarize a pull request, write a plain-English description of a PR, add a summary comment to a PR, or understand what a PR changes. Trigger when a user says "explain this PR", "summarize this pull request", "what does this PR do", "add a comment explaining the PR", or shares a GitHub PR URL and asks what it does.

Varnan-Tech/opendirectory

Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.

Varnan-Tech/opendirectory

Takes a competitor's public GitHub repo URL, fetches their open issues via the GitHub REST API, filters noise locally, clusters issues into 6 demand categories, computes a demand score per issue and per cluster, and outputs a ranked demand gap report with a GTM messaging brief. Use when asked to scan a competitor's GitHub issues, find what their users are begging for, turn GitHub complaints into product positioning, identify competitor feature gaps, or generate messaging from real user demand. Trigger when a user says "scan competitor issues", "what are users asking for on X repo", "find demand gaps in Y", "turn GitHub issues into messaging", or "what should I build based on competitor complaints".

Varnan-Tech/opendirectory

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and draft the actual docs fixes and content angles — with verbatim community quotes and source links as evidence.

Varnan-Tech/opendirectory

SEO keyword research workflow for blog generation using Google Trends data. Use when writing blog posts, planning content calendars, or optimizing articles for search engines. Finds breakout keywords, builds content structure, and generates SEO-optimized blog outlines targeting tech and developer audiences.

Varnan-Tech/opendirectory

Generates a professionally designed case study PDF for B2B SaaS sales and marketing. Supports 7 page layouts, 9 style presets, 1-4 page output. Trigger when user says "create a case study", "write a customer story", "make a case study PDF", "design a success story", "turn this customer win into a PDF".

Varnan-Tech/opendirectory

Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6. 1080×1080px default, 5 style presets, highlight annotations. Trigger when user says "create a chart", "visualize data", "make a bar chart", "line graph", "pie chart", "data visualization", "chart this data", "plot", "graph", or "visualize these numbers".

Varnan-Tech/opendirectory

Fetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked copy brief with positioning opportunities.

関連スキル