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-zh-CN/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
233
Token cost
~665 tokens
SKILL.md length
106 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 670 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 665 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 106 words of instructions outside code blocks.

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

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). 106 words, ~665 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 的友好上下文

目标是实现稳定的下游执行:下一个智能体应当知道要读什么、要做什么、什么算成功,以及哪些未解决的决策会改变结果。

本技能规范面向 LLM 的输出,使提示词、交接和生成的产物清晰明确。调用方提供产物类型以及任何产物特定的模板或输入契约;只包含其使用方用来决策、行动或验证所需的信息。当使用方根据字段分支处理时,使用已声明契约的字段名和取值含义。

核心规则

  1. 使用正向、可执行的指令

    • 说明下一个智能体应当做什么
    • 将质量策略转化为正向标准
    • 示例:“在已记录的兼容性用例中保持现有公共 API 行为不变。”
    • 只有在禁令保护不可逆边界或已发布契约时才保留它;此时要同时说明受保护的条件和允许的行动
  2. 将模糊指令具体化

    • 用可观测的条件、路径、命令、schema、示例或决策规则替代主观用词
    • 以下用词在把决策留给下一个智能体时通常需要澄清:appropriate(合适)、proper(恰当)、related(相关)、existing behavior(现有行为)、optional(可选)、as needed(按需)、if needed(如有需要)、per convention(按惯例)、未解决的备选方案、TBD(待定)、placeholder(占位符)
  3. 明确输出形态

    • 定义使用方会用到的章节、字段、表格列、JSON 键或检查清单项
    • 对于交接,仅在会影响下一步转换时才包含生成的产物路径和状态字段
  4. 提供最小且充分的上下文

    • “充分”是指对所分配的行动而言充分,而非提供完整背景:所包含的每一项都会被该行动或其必须产出的结果所使用
    • 包含该行动会用到的目的、来源产物、硬性约束、已接受的决策和未解决的条件
    • 优先使用具体的文件路径和章节提示,而非宽泛的模块名
    • 只要引用还能改变范围内的决策、行动或验证结果,就继续追踪;一旦下一个链接只是确认已经决定的内容,就停止
  5. 将复杂工作拆解为可验证的步骤

    • 将有 3 个及以上目标或存在先后依赖关系的工作拆分为有序步骤
    • 每个步骤都需要一个检查点:什么依据能证明它已完成
  6. 明确允许不确定性

    • 在将某个缺失的操作细节视为未解决之前,先从约束性产物和具有代表性的仓库依据中解决它
    • 记录剩余的不确定性及其对结果或证明的影响。在已确认的边界内做出可逆的、仓库本地的选择,并保留所用的依据
    • 将阻塞下一步的未知项转化为继续所需的具体、可验证依据要求。仅当已确认的成果、目标状态需求与非目标无法在没有用户选择的情况下同时成立时,或不可逆的外部行动需要授权时,才询问用户。当只是证明不可得时,完成不受影响的工作,并准确报告哪些内容无法验证及原因
  7. 保持约束的适度性

    • 只添加能减少歧义或保护真实需求的约束
    • 当目标行动、上下文和成功标准已经明确时,让简单的下游任务保持轻量
    • 将明确表述的规模预期——minimal(最小化)、a few lines(几行)、明确的行数或文件数估算——视为覆盖整个已完成差异的单一预算,而非按文件或按步骤分摊。当工作无法满足该预算时,报告超出情况及原因,而不是悄悄超支

改写模式

在将提示词、交接或产物视为完成之前,先应用以下改写。

模糊形式改写为
作为未解决选择使用的 optional必需、省略,或仅在指定条件下必需
下一个智能体必须从中选择的多个备选方案已选定的选项,或一条确定性的决策规则
as needed / if needed触发条件和所需的行动
per convention需要遵循的文件、函数、测试或已记录的惯例
related files具体的路径、通配符或搜索提示
existing behavior需要保持的可观测行为、源文件、测试、API 响应或 UI 状态
placeholder确切的临时值/行为、允许的依赖,以及验证预期
作为必需信息占位符使用的 TBD它会影响的决策以及继续所需的具体、可验证依据;如果该项对下游没有影响则省略
appropriate / proper可衡量的标准或检查清单

交接检查清单

在将提示词或产物发送给另一个智能体之前,请核实:

  • 目标行动是明确的
  • 已指明所需的输入路径、来源产物和与决策相关的事实
  • 所包含的每一项上下文都会被目标行动或其所需结果使用
  • 已接受的决策和约束只陈述一次,没有替代措辞
  • 已指定输出格式或预期的状态字段
  • 成功标准是可观测的
  • 模糊表达已被改写或标记为未解决
  • 任何明确表述的规模预期都以覆盖已完成差异的单一预算形式表达,并说明了超支上报条件
  • 下一个智能体能够根据提供的目的、来源、标准和依据完成其范围内的工作,或者明确返回继续所需的具体、可验证依据或权威工作流停止点

生成产物检查清单

在编写或最终确定生成的文档之前:

  • 每个需求、主张、任务、测试骨架或评审发现都有足够的来源上下文,可以追溯其存在原因
  • 每条可执行指令都指明了目标、行动和预期结果
  • 验证步骤说明了要运行或观察什么,以及什么结果证明成功
  • 如果某个产物源自另一个产物,被复制的决策在措辞和含义上保持一致
  • 任何明确表述的规模预期都以覆盖已完成产物的单一预算形式表达,并说明了超支上报条件
  • 缺失的信息记录了它所影响的决策或证明;只有已确认的价值边界选择或不可逆外部行动的授权才构成阻塞性上报

© 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-zh-CN/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-boilerplate233—~665Automated 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 3 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 8 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 25 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.

    233 GitHub stars~2.8k tokensUpdated 5 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.

    233 GitHub stars~3.5k tokensUpdated 5 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.

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

    shinpr/ai-coding-project-boilerplate

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

    233 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Implementation Approach

    shinpr/ai-coding-project-boilerplate

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

    233 GitHub stars~3.2k tokensUpdated 5 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.

    233 GitHub stars~8k tokensUpdated 5 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-zh-CN/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-zh-CN/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 665 tokens (SKILL.md is roughly 2.7k 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 233 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.