Agent skill

LLM Friendly Context

by shinpr in shinpr/ai-coding-project-boilerplate

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

MITAuto-check passed

Install LLM Friendly Context

skills CLI
$ npx skills add shinpr/ai-coding-project-boilerplate --skill llm-friendly-context -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shinpr/ai-coding-project-boilerplate llm-friendly-context --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills-ja/llm-friendly-context .claude/skills/llm-friendly-context && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
llm-friendly-context
GitHub stars
234
Token cost
~830 tokens
SKILL.md length
97 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 7 steps: 肯定形で実行可能な指示を使う → 曖昧な指示を具体化する → 出力構造を指定する → …
  • SKILL.md covers 中核ルール, 書き換えパターン, ハンドオフチェックリスト and 生成物チェックリスト
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering. The licence is MIT.

Example prompts

  • “/llm-friendly-context”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 肯定形で実行可能な指示を使う
  2. 曖昧な指示を具体化する
  3. 出力構造を指定する
  4. 必要十分な最小限のコンテキストを与える
  5. 複雑な作業を検証可能なステップに分解する
  6. 不確実性を明示的に許可する
  7. 制約は必要な分にとどめる

What it can do on your machine

Read from SKILL.md and the folder at commit 56913a2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

LLM Friendly Context loads about 830 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 97 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~830

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shinpr/ai-coding-project-boilerplate at commit 56913a2, republished under its MIT licence (© shinpr). 97 words, ~830 tokens.

Download SKILL.mdSave it as .claude/skills/llm-friendly-context/SKILL.md (or your agent's skills folder).
name
llm-friendly-context
description
入力・出力・成功基準・決定事項・未解決条件を明確化し、下流エージェントが推測せず実行できるようにする。LLM向けのプロンプト・ハンドオフ・計画成果物・レビュー・レポート・生成指示を記述または改訂する時に使用。

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つ以上、または逐次的な依存がある作業は、順序付きのステップに分割する
    • 各ステップには、何が完了を証明するかを示すチェックポイントを設ける
  6. 不確実性を明示的に許可する

    • 運用上の詳細が欠けている場合、未解決とみなす前に根拠となる成果物とリポジトリの代表的なエビデンスから解決する
    • 残る不確実性を、それが成果または証明に与える影響とともに記録する。確認済みの境界内では可逆なリポジトリローカルの選択を行い、使用したエビデンスを残す
    • 次のステップを妨げる不明点は、必要なエビデンスを具体的に示す。ユーザーに尋ねるのは、確認済みの成果、将来状態の要件、対象外をユーザーの選択なしには同時に維持できない場合、または不可逆な外部操作に承認が必要な場合に限る。証明だけを利用できない場合は、影響を受けない作業を完了し、検証できなかった内容と理由を正確に報告する
  7. 制約は必要な分にとどめる

    • 曖昧さを減らす、または実在の要件を守る制約だけを追加する
    • 対象アクション、コンテキスト、成功基準が既に明確な単純な下流タスクは、軽量なまま保つ
    • 指定された分量の目安 — minimal、数行、明示的な行数やファイル数の見積り — は、ファイル単位やステップ単位ではなく完成した差分全体に対する1つの上限として扱う。作業がそこに収まらない場合は、黙って超過せず超過分とその理由を報告する

書き換えパターン

プロンプト、ハンドオフ、成果物を完成とみなす前に、以下の書き換えを適用する。

曖昧な形書き換え後
未解決の選択として使われる optional必須、不要、特定条件下でのみ必須、のいずれか
次のエージェントが選ばなければならない複数の代替案選択した選択肢、または決定可能な判断ルール
as needed / if needed発動条件と必要なアクション
per convention従うべきファイル、関数、テスト、文書化された規約
related files具体的なパス、glob、検索の手掛かり
existing behavior維持すべき観測可能な振る舞い、出典ファイル、テスト、APIレスポンス、UI状態
placeholder正確な暫定値または振る舞い、許容される依存、検証の期待値
必須情報のプレースホルダとして使われる TBDそれが変えうる判断と、必要なエビデンス。下流への影響がなければ省略する
appropriate / proper測定可能な基準またはチェックリスト

ハンドオフチェックリスト

プロンプトや成果物を別のエージェントに渡す前に確認する:

  • 対象アクションが明示されている
  • 必須の入力パス、出典となる成果物、判断に関係する事実が指定されている
  • 含めたコンテキストはすべて、対象アクションかその必要な結果で使われる
  • 承認済みの判断と制約が、別の表現で重複せず一度だけ記載されている
  • 出力形式または期待されるステータスフィールドが指定されている
  • 成功基準が観測可能である
  • 曖昧な表現が書き換え済み、または未解決として明示されている
  • 指定された分量の目安が、完成した差分全体に対する1つの上限として表現され、超過を報告する条件が示されている
  • 次のエージェントが、渡された目的、出典、基準、エビデンスから自身のスコープを完了できるか、必要なエビデンスまたは正規のワークフロー停止条件を1つ正確に返せる

生成物チェックリスト

生成ドキュメントを記述または確定する前に確認する:

  • 各要件、主張、タスク、テストスケルトン、レビュー所見が、なぜ存在するかを辿れるだけの出典コンテキストを持つ
  • 実行可能な各指示に、対象、アクション、期待結果が明記されている
  • 検証ステップが、何を実行または観測するか、どの結果が成功を証明するかを述べている
  • ある成果物が別の成果物から導出される場合、コピーした判断が文言と意味の両面で一貫している
  • 指定された分量の目安が、完成した成果物全体に対する1つの上限として表現され、超過を報告する条件が示されている
  • 欠けている情報が、それによって影響を受ける判断または証明を記録している。作業を止めるエスカレーションとして扱うのは、確認済みの成果、将来状態の要件、対象外のどれを変更するかという選択、または不可逆な外部操作の承認だけである

© shinpr, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills-ja/llm-friendly-context of shinpr/ai-coding-project-boilerplate.

Open the folder on GitHubat commit 56913a2

Compare with similar skills

LLM Friendly Context next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

LLM Friendly Context compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
LLM Friendly Context this skillshinpr/ai-coding-project-boilerplate234—~830Automated safety check: PassMIT
Friendlybergside/awesome-design-skills3.1k1 repos~884Automated safety check: PassMIT
Make Friends As An Adultmohitagw15856/pm-claude-skills1.4k—~1.2kAutomated safety check: PassMIT
Mobile Friendlykostja94/marketing-skills1k—~1.5kAutomated safety check: PassMIT
Yao Geo Article Friendlyyaojingang/yao-geo-skills871—~719Automated safety check: PassMIT
Support A Friend In Crisismohitagw15856/pm-claude-skills1.4k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Friendly

    bergside/awesome-design-skills

    Approachable, intuitive design with rounded elements, ample whitespace, and soft pastel color palettes.

    3.1k GitHub starsUsed in 1 repo~884 tokens
    Frontend & DesignAuto-check passed
  • Make Friends As An Adult

    mohitagw15856/pm-claude-skills

    Build a real plan to make friends as an adult — where to meet people you'd actually click with, how to turn acquaintances into friends, and past the awkwardness.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Mobile Friendly

    kostja94/marketing-skills

    When the user wants to optimize for mobile-first indexing or fix mobile usability.

    1k GitHub stars~1.5k tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Yao Geo Article Friendly

    yaojingang/yao-geo-skills

    Optimize an existing article or local article file into a GEO and AI-search-friendly rewrite with source-bound evidence, structure, semantic density, scoring, and change notes.

    871 GitHub stars~719 tokensUpdated 9 days ago
    Research & ScienceAuto-check passed
  • Support A Friend In Crisis

    mohitagw15856/pm-claude-skills

    Show up well for someone going through something hard — loss, illness, a breakup, a crisis — with the right words, the right presence, and concrete help, instead of freezing or saying the wrong thing.

    1.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Friendly Python

    PsiACE/skills

    Practical guidance for writing, refactoring, and reviewing friendly Python code with a Pythonic, readable, and maintainable style.

    173 GitHub stars~771 tokensUpdated 26 days ago
    DevelopmentAuto-check passed

More from shinpr/ai-coding-project-boilerplate

All 41 skills in this repo
  • Integration E2E Testing

    shinpr/ai-coding-project-boilerplate

    Selects and designs the smallest integration/E2E test set that proves accepted behavior at an observable boundary.

    234 GitHub stars~2.8k tokensUpdated 6 days ago
    Auto-check passed
  • Skill Optimization

    shinpr/ai-coding-project-boilerplate

    Evaluates and optimizes skill file quality using 9 content patterns and 10 editing principles.

    234 GitHub stars~3.5k tokensUpdated 6 days ago
    Auto-check passed
  • Frontend Technical Spec

    shinpr/ai-coding-project-boilerplate

    Defines React environment, component architecture, state/data flow, build verification, and frontend non-functional criteria from repository evidence.

    234 GitHub stars~1.9k tokensUpdated 6 days ago
    Auto-check: notes
  • Frontend Typescript Rules

    shinpr/ai-coding-project-boilerplate

    Applies React/TypeScript type safety, component design, and state management rules.

    234 GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed
  • Implementation Approach

    shinpr/ai-coding-project-boilerplate

    Selects implementation strategy (vertical slice, horizontal, or hybrid) with risk assessment.

    234 GitHub stars~3.2k tokensUpdated 6 days ago
    Auto-check passed
  • Subagents Orchestration Guide

    shinpr/ai-coding-project-boilerplate

    Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows.

    234 GitHub stars~8k tokensUpdated 6 days ago
    Auto-check passed

Questions about LLM Friendly Context

What does LLM Friendly Context do?

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

How do I install LLM Friendly Context in Claude Code?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill llm-friendly-context -a claude-code`. Or copy the skill folder (.claude/skills-ja/llm-friendly-context in shinpr/ai-coding-project-boilerplate) into .claude/skills/llm-friendly-context in your project. Claude Code loads it when a task matches its description.

How do I install LLM Friendly Context in Codex?

Run `npx skills add shinpr/ai-coding-project-boilerplate --skill llm-friendly-context -a codex`. Or copy the skill folder (.claude/skills-ja/llm-friendly-context in shinpr/ai-coding-project-boilerplate) into .agents/skills/llm-friendly-context in your project. Codex loads it when a task matches its description.

Can I use LLM Friendly Context in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shinpr/ai-coding-project-boilerplate --skill llm-friendly-context -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/llm-friendly-context, .gemini/skills/llm-friendly-context, .github/skills/llm-friendly-context and .opencode/skills/llm-friendly-context in your project.

What does LLM Friendly Context need to run?

SKILL.md names no scripts, command-line tools or credentials: LLM Friendly Context is instructions for the agent only.

Does LLM Friendly Context access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is LLM Friendly Context safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does LLM Friendly Context use?

LLM Friendly Context is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does LLM Friendly Context use?

About 830 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to LLM Friendly Context?

Skills that share tags, products or a category with LLM Friendly Context: Friendly (bergside/awesome-design-skills, 3.1k stars), Make Friends As An Adult (mohitagw15856/pm-claude-skills, 1.4k stars), Mobile Friendly (kostja94/marketing-skills, 1k stars) and Yao Geo Article Friendly (yaojingang/yao-geo-skills, 871 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains LLM Friendly Context?

shinpr (a GitHub user) maintains it in shinpr/ai-coding-project-boilerplate, which has 234 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 4, 2026.

Source: shinpr/ai-coding-project-boilerplate on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.