AF skill-progressive-disclosure-design
Определите, как разделить контент навыка между SKILL.md и справочными файлами для эффективности контекста и надежного срабатывания. Используйте это всякий раз, когда создаете новый навык Claude, рефакторите существующий или когда SKILL.md становится слишком длинным (более 300-400 строк). Также активируйте, когда пользователь упоминает «прогрессивное раскрытие», «справочные файлы», «разделение навыков», «пакетирование навыков», «контекстное окно для навыков», «SKILL.md слишком длинный», «что поместить в references/», «структура навыка» или выражает неуверенность в том, куда поместить контент внутри навыка. Используйте это, даже если пользователь формулирует вопрос как проблему срабатывания («как мне улучшить срабатывание моего навыка»), поскольку этот вопрос часто путают с вопросом о разделении, и его необходимо сначала разъяснить.
машинный переводПоказать оригиналСкрыть оригинал«Decide how to split skill content between SKILL.md and reference files…»
Decide how to split skill content between SKILL.md and reference files for context efficiency and reliable triggering. Use this whenever creating a new Claude skill, refactoring an existing one, or when a SKILL.md is growing past 300-400 lines. Also trigger when the user mentions "progressive disclosure", "reference files", "splitting skills", "skill bundling", "context window for skills", "SKILL.md too long", "what goes in references/", "skill structure", or expresses any uncertainty about where to put content within a skill. Use this even if the user phrases the question as a triggering problem ("how do I make my skill trigger better"), because that question is often confused with the splitting question and needs to be disentangled first.
Определите, как разделить контент навыка между SKILL.md и справочными файлами для эффективности контекста и надежного срабатывания. Используйте это всякий…
Как процесс F 54/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: references/*, scripts/*, references/<variant>.md
Как улучшить
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
missing-refссылка на отсутствующий файл: references/* - предупреждение
missing-refссылка на отсутствующий файл: scripts/* - предупреждение
missing-refссылка на отсутствующий файл: references/<variant>.md - предупреждение
missing-refссылка на отсутствующий файл: references/edge-cases.md - предупреждение
missing-refссылка на отсутствующий файл: references/*.md
Процессный рейтинг: все десять параметров 54/100
- 0Инструменты и файлы. Не хватает 5 файла(ов): references/*, scripts/*, references/<variant>.md
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 9, без проверки текущего состояния
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Ошибки и развилки. Развилок: 11
- 100Шаги. Шагов: 132
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 3991 токенов
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Среди тестов нет случая на инъекцию через данные
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +2Инструкции на одном языке
- +5В description 9 примера фраз-триггеров в кавычках
- +3Длина description 750 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 24 заголовков
- +3Пошаговые инструкции: 132 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (1 блоков кода)
- +1Лицензия указана
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 81.