llms-txt-writerlisted
Install: claude install-skill shimo4228/claude-harness
# llms-txt-writer — AI-Facing Writing Skill
AI 検索エンジン(ChatGPT / Perplexity / Gemini)と AI エージェントに引用・参照されることを最適化した文書を書くスキル。静的解析(GEO-SFE)と Answer.AI llms.txt 標準の両方をカバーする。
## When to Use
以下のいずれかに該当するとき:
- `llms.txt` / `llms-full.txt` を新規作成・更新する
- FAQ / 用語集など AI 検索引用を狙うドキュメントを書く
- 既存の AI-facing 文書の GEO スコアを診断・改善する
**使わない場面**:
- README / repo のトップページ(`readme-writer` を使う — 証拠スクリプト + fresh context の判定器 + review panel を持つ)
- 記事 / エッセイ / ブログポスト等の人間向けコンテンツ(`writing-ecosystem` を使う)
- 人間可読性を最優先したいドキュメント
---
## Audience Separation: Human vs AI
ドキュメントは **人間 primary** か **AI primary** かで最適化が根本的に異なる。1 ファイルで両立させると、どちらにも中途半端になる。
| 軸 | 人間 primary | AI primary |
|----|-------------|------------|
| 構造 | 物語的、段落で流れる | Q&A / 定義形式、H2 独立 chunk |
| 見出し | 宣言形で簡潔 | 質問形で 20%+ |
| エンティティ配置 | 文脈に合わせて自然に | 冒頭 30% に 45%+ 集中(ski-ramp) |
| 定義 | 文脈から読み取れる | `X is defined as Y` を明示 |
| セクション長 | 論点重要度に比例 | 50-150 語 / 150-450 字に揃える |
| 読みやすさ | 最優先 | 犠牲にしてよい |
本 skill は **AI primary の最適化のみ扱う**。
---
## Answer.AI llms.txt Standard(**v2** — as-of 2026-08-23 に一次ソース確認)
[llmstxt.org](https://llmstxt.org/)(Jeremy Howard / Answer.AI。2024-09-03 公開、**v2 は 2026-08-10 更新**)。
**spec が定めるのは `llms.txt` だけ**:
- **必須は H1(プロジェクト名)のみ**。順序は BOM(任意)→ H1 → 要約 blockquote →
見出し以外の詳細 markdown → H2 区切りのファイルリスト
- **`Optional` セクション** = 二次情報。「より短い context が要るときエージェントが
スキップしてよいリンク」という意味(機械的な必須/任意の区別ではない)
- **発見用の link relation**(HTTP `Link` ヘッダまたは HTML `<link>` で提供する):
`rel="describedby"` → llms.txt 本体、`rel="alternate" type=