К основному содержанию
скилл CX Codex

llm-friendly-context — скилл для Claude Code: установка и правила

Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха.

MIT ★ 720 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/llm-friendly-context/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
llm-context brave Скилл llm-context извлекает готовый контекст веб-страниц через API Brave Search для заземления ответов ИИ. Пригодится при настройке RAG и автономных агентов. CX Codex +1 1 300установок context-network jwynia Скилл context-network помогает выстроить и поддерживать сеть контекста проекта, когда документация разрознена или агент забывает детали между сессиями. CX Codex +1 449установок context-builder mvschwarz Скилл context-builder собирает контекст по фиче из заметок встреч, конкурентного анализа и регуляторных требований. Создаёт файл background.md и обновляет общую базу знаний. CX Codex +1 ★ 8 928звёзд репо establishing-project-context GanyuanRan Скилл establishing-project-context для Claude Code ведёт словарь доменных терминов проекта в CONTEXT.md. Обновляет его при появлении нового понятия, переименовании или конфликте терминов. CX Codex +1 ★ 1 450звёзд репо external-context Yeachan-Heo Скилл external-context для Claude Code разбивает запрос на аспекты и запускает агентов для параллельного поиска в документации и веб. Собирает контекст по теме или сравнивает подходы. CX Codex +1 861установок LLM Text docker MCP-сервер LLM Text для Claude Code, который находит и загружает файл llms.txt со сложных сайтов. Нужен, чтобы агент Claude мог прочитать инструкции и модели, которые опубликовал владелец сайта. CX Codex +1

Из того же набора43

Весь набор →
task-decomposer Субагент task-decomposer для Claude Code превращает пункты утверждённого Work Plan в файлы задач. Создаёт отдельный файл для каждой задачи. CX Codex ★ 720звёзд репо acceptance-test-generator Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton. CX Codex ★ 720звёзд репо requirement-analyzer Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой. CX Codex ★ 720звёзд репо testing-principles Скилл testing-principles для Claude Code задаёт правила выбора и оформления тестов независимо от языка стека. Включается при написании новых тестов, проверке их качества и выборе между unit-, integration- и E2E-уровнями. CX Codex +1 ★ 720звёзд репо requirement-convergence Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо work-planner Субагент work-planner для Claude Code превращает утверждённые Design Doc в план реализации с задачами, зависимостями и проверками. Запускается при запросе плана работ или планирования задач. CX Codex ★ 720звёзд репо typescript-rules Набор правил для фронтенд-разработки на React и TypeScript: типобезопасность, устройство компонентов, владение состоянием и обработка ошибок. CX Codex +1 ★ 720звёзд репо documentation-criteria Скилл documentation-criteria для Claude Code определяет, какие документы нужны изменению и где их хранить. Агент подключает его при выборе объёма документации или создании и проверке технического документа. CX Codex +1 ★ 720звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой