agentleFS
Abdullokh-NAbdullokh-N/proza-ru/skills/shared-dao/SKILL.md

shared-dao

Skill0 starsChanged 2 months agoApache-2.0View on GitHub

Общие соглашения для всех скилов набора — тон инструкций, формат чек-листов, ссылки на resources, пометки уверенности, пределы длины.

Files
SKILL.md

Общие соглашения набора

Тон

Скил читает модель, а не человек на досуге. Пиши инструкцию, не эссе.

  • Повелительное наклонение, второе лицо: «считай», «останови», «вынеси автору».
  • Без похвалы, ободрения и вводных «важно понимать, что».
  • Без метафор о ремесле. Правило описывается операцией, а не образом.
  • Каждое правило проверяемо: содержит число, список или тест. «Пиши живо» — вон. «Два причастных оборота в предложении — правка» — годится.

Чек-листы

  • Формат - [ ], каждый пункт — вопрос с ответом да/нет.
  • Не больше семи пунктов. Длиннее — разбить или сократить.
  • Ставится в конце файла, а не в середине.
  • Пункт, который нельзя проверить за минуту, из чек-листа убирается.

Ссылки на resources

  • Относительный путь от SKILL.md: resources/имя-файла.md.
  • Рядом одно предложение о том, когда файл открывать.
  • Ресурс заводится, когда справочный материал перерос тридцать строк. До этого он живёт в теле скила.

Пометки уверенности

ПометкаЗначение
[проверено]прогнано на реальном тексте, число получено из прогона
[оценка]разумное предположение, основание названо
[не проверено]порог взят из общих соображений

Числовой порог без пометки не приводить. Пока анализатор не прогнан, все его пороги — [не проверено].

Длина

  • Инфраструктурный скил — до 50 строк.
  • Скил ремесла — до 150 строк.
  • Ресурс — без ограничения, но с оглавлением от тридцати строк.

Примеры

Свои. Отрывки из чужих книг не воспроизводятся ни в примерах, ни в файлах стиля. Приём разбирать можно, чужой текст в контекст не тащим. Разбор чужой манеры как карты приёмов — скил author-devices: он работает внутри этого правила, а не в обход него.

Пример должен быть минимальным: одна фраза «до», одна «после», без обрамления.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.