agentleFS
shakhruzshakhruz/mila-core/skills/plain-words/SKILL.md

plain-words

Skill3 starsChanged 13 days agoApache-2.0View on GitHub

Apply to EVERY question to the owner, panel card, button and «waiting for your word» line: panel language after ASD-STE100. Not for chat. RU: вопрос владельцу, карточка выбора, кнопки, «ждёт вашего слова».

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

When to use (full): «Clear» (Yasno): panel language so the owner understands a question, choice card or button on first read. Rules after aviation ASD-STE100 plus a Russian panel dictionary. Apply to EVERY question to the owner, panel card, button and «waiting for your word» line. Not for chat or outward texts. RU: «Ясно» — язык пульта: как Мила пишет владельцу вопрос, карточку выбора и кнопки, чтобы он понял с первого прочтения. Правила по образцу авиационного ASD-STE100 (совет Карпаты 10.2026) и русский словарь пульта. Применять к КАЖДОМУ вопросу владельцу, карточке пульта, кнопкам и строке «ждёт вашего слова». Обычную переписку и тексты наружу не трогает.

«Ясно» — язык пульта

«мне не понятны вопросы… для управления Милой — для пультов — нужна максимальная ясность и понятность. Качество общения не должно меняться».

Основа — ASD-STE100 (Simplified Technical English): язык авиационных инструкций, где у слова одно значение, а предложение короткое, чтобы техник понял его с первого раза, уставшим и на чужом языке. Карпаты в октябре 2026 предложил просить модели писать «на 80 % по ASD-STE100». Сам словарь STE — английский и под авторским правом ASD; здесь не перевод, а наши правила по его образцу и свой русский словарь.

Где действует: вопрос владельцу, карточка пульта, текст кнопок, строка «ждёт вашего слова», шапка пульта. Где не действует: разговор, отчёт, пост, письмо, текст клиенту — там прежний живой язык.

Девять правил

  1. Одна карточка — одно решение. Два вопроса — две карточки.
  2. Первая строка — само решение, вопросом, до 12 слов. «Выложить новый example.com сейчас?», а не «Курс сотрудника: если руководитель выберет…». С 28.10 (навык iniciativa): в личке первой строкой — моё предложение («Предлагаю выложить example.com сейчас — всё проверено.»); на карточке выбора — вопрос, но с «⭐ Советую» и последствием у каждого варианта. Голый вопрос без рекомендации — не отправляю.
  3. Не больше 20 слов в любом предложении. Нет «если…, то…» внутри вопроса: условие — отдельной строкой «Когда: …».
  4. Каждый вариант — что произойдёт. Кнопка: глагол + что, до 4 слов («Выложить сейчас», «Подождать видео»). Под вопросом одна строка на вариант: «А — <действие> → <результат>».
  5. Рекомендация — ★ и одно «потому что». «★ А — трафик уже идёт».
  6. Одно слово — одно значение. Выбрали «сайт» — не пишем «страница», «лендинг». Словарь ниже.
  7. Без внутреннего. Нет номеров сообщений и задач (M-0001, 8999, 12345), кодов роликов (R4), английских слов (трекшн, деплой, Milestone, превью), названий файлов. Номер нужен — в конце, мелко: «(12345)».
  8. Кто и когда — словами. «Мила клиентов напишет им сегодня до 18:00 по Ташкенту», а не «в их рабочих чатах».
  9. Кнопки — только ответы. Под вопросом только варианты ответа и «💬 Поясни». Никаких «Решай сама», «Пауза», «Как дела?» на карточке выбора.

Словарь пульта

Глаголы (одно значение каждый): выложить (сделать видимым всем) · отправить (одному человеку или в чат) · показать (вам, до выкладки) · оплатить · пополнить (баланс) · купить · продлить · отменить · удалить · включить · выключить · проверить · подождать · написать · позвонить · пригласить · поручить (Миле) · решить · оставить (как есть) · заменить · добавить · убрать · начать · закончить · перенести (на дату)

Существительные: сайт · пост · ролик · письмо · сообщение · чат · канал · клиент · деньги · баланс · счёт · цена · срок · день · неделя · сегодня · завтра · ошибка · черновик (не «превью») · проверка (не «стенд», «прогон») · этап (не «Milestone») · рост (не «трекшн») · заявка · встреча · подписка · ключ · вход

Замены (слева — нельзя на пульте, справа — можно):

НельзяПишем
превьючерновик сайта
выкладка, деплой, прод, «на прод»выложить (сделать видимым всем), на сайте
стенд, прогон, перегонпроверка
трекшнрост, цифры
Milestoneэтап
онбордингзнакомство
компаньон (о клиентской Миле)Мила клиента
эскалацияпередать вам
дедлайнсрок
апрув, «да» наваше решение
таргетреклама
лидчеловек, который написал

Шаблон карточки

<Решение вопросом, ≤12 слов>
А — <действие> → <результат>
Б — <действие> → <результат>
★ А — <одно «потому что»>
Когда: <если есть условие или срок>

Кнопки: ★ <А, ≤4 слова> · <Б, ≤4 слова> · 💬 Поясни.

Было → стало (13.10, реальные карточки)

Было: «🔀 5 · Курс сотрудника: если руководитель выберет «15 минут показа» — кто проводит? ★ А — Мила и её коллега сами, на экране; вы — по желанию» + кнопки «Решай сама», «Пауза».

Стало:

Кто показывает курс руководителю за 15 минут?
А — Мила и её коллега сами → вам не нужно время
Б — вы вместе с ними → сильнее, но 15 минут ваших
★ А — они уже знают курс
Когда: если руководитель выберет показ, а не текст

Кнопки: ★ Мила с коллегой · Вместе со мной · 💬 Поясни.

Проверка перед отправкой

python3 ~/.claude/skills/plain-words/plain_words_check.py "<текст карточки>" — выдаёт замечания: длинные предложения, слова из колонки «Нельзя», номера и коды, больше одного «?». Нет замечаний — отправляю.

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.