llm-friendly-context SKILL.md skillA

llm-friendly-context from shinpr/ai-coding-project-boilerplate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add shinpr/ai-coding-project-boilerplate/llm-friendly-context@git:20260923.86a3d79

Pins git:20260923.86a3d79 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

shinpr/ai-coding-project-boilerplate

Path

.claude/skills-ja/llm-friendly-context/SKILL.md

Versions recorded

5

Latest version

git:20260923.86a3d79, committed Sep 23, 2026

First version recorded

Aug 9, 2026

Size

8,399 bytes

Repository stars

234

License

MIT

入力・出力・成功基準・決定事項・未解決条件を明確化し、下流エージェントが推測せず実行できるようにする。LLM向けのプロンプト・ハンドオフ・計画成果物・レビュー・レポート・生成指示を記述または改訂する時に使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# LLM-Friendly Context

目標は、下流が安定して実行できるようにすることである。次のエージェントが、何を読み、何をし、何をもって成功とし、どの未解決の判断が結果を変えうるかを把握できる状態を目指す。

このスキルはLLM向け出力（プロンプト、ハンドオフ、生成物）の明確さを扱う。生成物の種類と、生成物固有のテンプレートまたは入力契約は呼び出し元が渡す。利用側が判断、実行、検証に使う情報だけを含める。利用側が値によって分岐する場合は、宣言された契約のフィールド名と値の意味を使用する。

## 中核ルール

1. **肯定形で実行可能な指示を使う**
   - 次のエージェントが何をすべきかを述べる
   - 品質ポリシーは肯定的な基準に変換する
   - 例: 「文書化された互換ケース全体で、既存の公開APIの振る舞いを維持する」
   - 禁止形を残すのは、それが不可逆な境界またはリリース済みの契約を守る場合に限る。その場合は、守る条件と許容されるアクションを併記する

2. **曖昧な指示を具体化する**
   - 主観的な語を、観測可能な条件、パス、コマンド、スキーマ、例、判断ルールに置き換える
   - 次のエージェントに判断を委ねる場合に明確化が必要になりやすい語: `appropriate`、`proper`、`related`、`existing behavior`、`optional`、`as needed`、`if needed`、`per convention`、未解決の代替案、`TBD`、`placeholder`

3. **出力構造を指定する**
   - 利用側が使うセクション、フィールド、表のカラム、JSONキー、チェックリスト項目を定義する
   - ハンドオフでは、次の遷移を制御する場合に限り、生成した成果物のパスとステータスフィールドを含める

4. **必要十分な最小限のコンテキストを与える**
   - 十分かどうかは、背景の網羅ではなく割り当てたアクションに対して判断する。含めた情報はすべて、そのアクションか、それが生み出すべき結果で使われる
   - 目的、出典となる成果物、厳格な制約、承認済みの判断、未解決条件のうち、そのアクションが使うものを含める
   - 大まかなモジュール名より、具体的なファイルパスとセクションヒントを優先する
   - 参照は、スコープ内の判断、アクション、検証結果を変えうる間はたどる。次のリンクが既に決まった内容を確認するだけになった時点で止める

5. **複雑な作業を検証可能なステップに分解する**
   - 目的が3つ以上、または逐次的な依存がある作業は、順序付きのステップに分割する
   - 各ステップには、何が完了を証明するかを示すチェックポイントを設ける
…

Read the whole file at its exact version.

How to install

mdr add shinpr/ai-coding-project-boilerplate/llm-friendly-context@sha256:5566d5f2c5213714

[![mdr](https://markdownregistry.com/badge/art_kauvk4vjq2hn4jrm.svg)](https://markdownregistry.com/a/art_kauvk4vjq2hn4jrm)

Versions

The registry has recorded 5 versions of this file, between Aug 9, 2026 and Sep 23, 2026, about one every 11 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_kauvk4vjq2hn4jrm
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/ai-coding-project-boilerplate/llm-friendly-context
GET https://markdownregistry.com/api/v1/blob/5566d5f2c52137149fee8f5791b95ff282e4e1acceb8700b31861036879e97b3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shinpr/ai-coding-project-boilerplate

Every file in shinpr/ai-coding-project-boilerplate

Other files named llm-friendly-context

Browse by kind, by grade A, or by owner.