llm-friendly-context — скилл для Claude Code: установка и правила
Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха.
MIT ★ 720 обновлён 2026-10-29
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a claude-codeЧто делает llm-friendly-context
Скилл правит текст, который потом читает другая модель: промпты, хендоффы, планы, ревью, отчёты, сгенерированные инструкции. Задача одна — чтобы следующий исполнитель знал, что читать, что делать, что считается успехом и какие решения ещё не приняты.
Внутри SKILL.md семь правил, таблица переписываний и два чек-листа: для передачи работы и для готового артефакта. Таблица бьёт по конкретным словам — appropriate, as needed, per convention, related files, placeholder, TBD: вместо них нужно назвать условие, файл или измеримый критерий.
Запрет скилл оставляет только там, где тот защищает необратимую границу или уже выпущенный контракт, и требует рядом назвать разрешённое действие. Формулировки он правит, код не трогает. Если задача неясна по сути, замена appropriate на измеримый критерий её не спасёт: вопрос придётся вернуть владельцу решения.
Какие задачи решает
- переписать промпт, чтобы следующая модель не гадала, что от неё хотят
- убрать из хендоффа
as neededиper convention, подставив условие и действие - прогнать чек-лист перед отправкой артефакта другому агенту
- зафиксировать нерешённые вопросы с владельцем решения и последствием
- сократить контекст до того, что реально нужно для шага
Примеры запросов агенту
- Перепиши
handoff.mdпо правилам скилла llm-friendly-context: назови входы, шаги и критерии успеха. - Проверь этот промпт чек-листом хендоффа из llm-friendly-context и покажи, что осталось расплывчатым.
- Приведи отчёт к виду, по которому следующий агент сможет работать без вопросов.
Как установить llm-friendly-context
1Через Skills CLI (Vercel)
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a claude-code2Вручную: положить файлы
~/.claude/skills/llm-friendly-context/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/llm-friendly-context/
1Через Skills CLI (Vercel)
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a codex2Вручную: положить файлы
.agents/skills/llm-friendly-context/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a cursor2Вручную: положить файлы
.cursor/skills/llm-friendly-context/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install shinpr/claude-code-workflows dev-skills/skills/llm-friendly-context2Вручную: положить файлы
.github/skills/llm-friendly-context/SKILL.md1Через Skills CLI (Vercel)
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a gemini-cli2Командой платформы
gemini skills install https://github.com/shinpr/claude-code-workflows --path dev-skills/skills/llm-friendly-contextВручную: положить файлы
.devin/skills/llm-friendly-context/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о llm-friendly-context
Как установить llm-friendly-context в Claude Code?
Выполните npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a claude-code. Файл скилла окажется по пути ~/.claude/skills/llm-friendly-context/SKILL.md.
Что делает llm-friendly-context?
Приводит промпты, хендоффы и сгенерированные документы к виду, по которому следующий исполнитель действует без догадок: названы входы, шаги, критерии приёмки и нерешённые вопросы с владельцем.
Оставляет ли скилл запреты в инструкциях?
Только если запрет защищает необратимую границу или уже выпущенный контракт, и тогда рядом нужно назвать защищаемое условие вместе с разрешённым действием. Остальные запреты переписываются в позитивные инструкции.
Исходный текст
SKILL.md · MIT
--- name: llm-friendly-context description: Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute without guessing. Use when writing or revising LLM-facing prompts, handoffs, planning artifacts, reviews, reports, or generated instructions. --- # LLM-Friendly Context The goal is stable downstream execution: the next consumer should know what to read, what to do, what counts as success, and which unresolved decisions can change the result. ## Core Rules 1. **Use positive, executable instructions** - State what the next consumer should do. - Convert quality policies into positive criteria. - Keep a prohibition only when it protects an irreversible boundary or shipped contract. Name the protected condition and the allowed action. - Example: "Preserve existing public API behavior across the documented compatibility cases." 2. **Make vague instructions concrete** - Clarify wording when plausible interpretations would change the outcome, scope, authority or proof. Supply purpose, evidence and selection criteria for reversible choices; reserve exact selections for actual consumer contracts and user-owned decisions. - Terms that often need clarification when they leave a decision to the next consumer: `appropriate`, `proper`, `related`, `existing behavior`, `optional`, `as needed`, `if needed`, `per convention`, unresolved alternatives, `TBD`, `placeholder`. 3. **Specify output shape** - Use the sections, fields, table columns, JSON keys, or checklist items the consumer uses. - For handoffs, include only produced artifact paths and status fields that control the next transition. 4. **Provide the smallest sufficient context** - Sufficient means sufficient for the assigned action, not complete background: every item you include is consumed by that action or by the result it must produce. - Include the purpose, source artifacts, hard constraints, accepted decisions, and unresolved conditions that action consumes. - Prefer concrete file paths and section hints over broad module names. - Follow references while they can change an in-scope decision, action, or verification result. 5. **Decompose complex work into verifiable steps** - Expose real dependencies and their completion evidence. Let independent reversible work follow the route suited to the task. - Each step needs a checkpoint: what evidence proves it is complete. 6. **Permit uncertainty explicitly** - Resolve missing operational detail from referenced artifacts and repository evidence before treating it as unresolved. - Record remaining uncertainty with its effect, required input, and decision owner. Make reversible repository-local choices when governing evidence resolves them. 7. **Keep constraints proportionate** - Add only constraints that reduce ambiguity or preserve a real requirement. - Keep simple downstream tasks lightweight when the target action, context, and success criteria are already clear. - Interpret minimal as the least downstream complexity that fully solves the problem. An explicit user diff limit is a constraint; otherwise necessary corrections are not bounded by a line count. ## Rewrite Patterns Use these rewrites before treating a prompt, handoff, or artifact as complete. | Ambiguous form | Rewrite as | |---|---| | `optional` used as an unresolved choice | Required, omitted, or required only under a named condition | | Alternatives whose choice changes a protected outcome | The governing constraint or unresolved owner decision; for reversible choices, purpose, evidence and selection criteria | | `as needed` / `if needed` | The triggering condition and required action | | `per convention` | The file, function, test, or documented convention to follow | | `related files` | Specific paths, globs, or search hints | | `existing behavior` | The observable behavior, source file, test, API response, or UI state to preserve | | `placeholder` | Exact temporary value/behavior, allowed dependencies, and verification expectation | | `TBD` used as a placeholder for required information | A blocking unresolved item with owner, required input, and decision effect | | `appropriate` / `proper` | A measurable criterion or checklist | ## Handoff Checklist Before sending a prompt or artifact to another consumer, verify: - [ ] The target action is explicit. - [ ] Required input paths, source artifacts, and decision-relevant facts are named. - [ ] Every included context item is consumed by the target action or its required result. - [ ] Accepted decisions and constraints use one canonical wording. - [ ] Output format or expected status fields are specified. - [ ] Success criteria are observable. - [ ] Outcome-relevant ambiguities are resolved or assigned to their decision owner; harmless execution flexibility remains. - [ ] Each instruction states the allowed action; each retained prohibition names the protected condition and allowed alternative. - [ ] The next consumer can complete its scope from the supplied purpose, sources, criteria, and evidence, or return the exact unresolved decision and owner. ## Generated Artifact Checklist Before writing or finalizing a generated document: - [ ] Each requirement, claim, task, test skeleton, or review finding has enough source context to trace why it exists. - [ ] Every executable instruction names the target, action, and expected result. - [ ] Verification steps say what to run or observe and what result proves success. - [ ] Each instruction states the allowed action; each retained prohibition names the protected condition and allowed alternative. - [ ] If an artifact is derived from another artifact, copied decisions stay consistent in wording and meaning. - [ ] If downstream work is blocked by missing information, the artifact records the missing input, decision owner, and effect.
© shinpr · MIT · shinpr/claude-code-workflows