SKILLEMALL.ai

CC python

Клиент Vovk.ts для Python — генерация типизированного пакета Python из API Vovk с помощью `vovk-python`, шаблонов `py` / `pySrc`, форм `TypedDict`, потребления JSON + JSON Lines, клиентской валидации и публикации в PyPI. Используйте, когда пользователь хочет типизированный Python SDK, постоянную интеграцию Python или публикацию в PyPI — фразы вроде «сгенерировать Python-клиент / SDK», «выпустить пакет Python для моего API», «использовать vovk-python», «шаблон pySrc», «потоковая передача Python-клиента», «опубликовать в PyPI». НЕ охватывает создание контроллера / процедуры → передать навыку `procedure`. НЕ охватывает `vovk bundle` в целом → передать навыку `bundle`. НЕ охватывает JSON Lines на стороне сервера → передать навыку `jsonlines`. **НЕ охватывает одноразовые HTTP-вызовы** — конечные точки Vovk — это обычный REST, поэтому вызов `curl`, `httpx` или `requests` против `/api/...` является более простым решением для случаев, когда «мне просто нужно обратиться к моему API из скрипта Python / CLI / оболочки». Используйте этот навык только тогда, когда пользователь действительно хочет сгенерированный типизированный клиентский код.

машинный переводПоказать оригиналСкрыть оригинал«The Vovk.ts Python client — generating a typed Python package from a V…»

The Vovk.ts Python client — generating a typed Python package from a Vovk API with `vovk-python`, the `py` / `pySrc` templates, `TypedDict` shapes, JSON + JSON Lines consumption, client-side validation, and PyPI publishing. Use whenever the user wants a typed Python SDK, ongoing Python integration, or PyPI publishing — phrasings like "generate a Python client / SDK", "ship a Python package for my API", "use vovk-python", "pySrc template", "python client streaming", "publish to PyPI". Does NOT cover controller / procedure authoring → hand off to `procedure` skill. Does NOT cover `vovk bundle` in general → hand off to `bundle` skill. Does NOT cover JSON Lines server-side → hand off to `jsonlines` skill. **Does NOT cover one-off HTTP calls** — Vovk endpoints are plain REST, so a `curl`, `httpx`, or `requests` call against `/api/...` is the simpler answer for "I just want to hit my API from a Python script / CLI / shell" use cases. Reach for this skill only when the user actually wants generated typed client code.

Разбор skillemall

Скилл учит ИИ генерировать типизированный Python-клиент из Vovk API через vovk-python и шаблоны py/pySrc. Обещает TypedDict, валидацию на клиенте, поддержку JSON Lines и публикацию на PyPI.

Файл один, описание обрезано (lint ругается на длину). Проверок на моделях не было, песочницы нет. Оценка C: quality 61, process 52 — скилл работает, но инструкция неполная. Критических проблем не найдено, но medium/low findings не указаны явно.

Ставить можно, если вам нужен именно Vovk-клиент и вы готовы дополнить инструкцию сами. На моделях не тестировалось, поэтому первый запуск — лотерея.

finom/vovk Agent Skills автор: finom 1 файл тело ≈ 2 998 токенов Открыть источникgithub.com↗ проанализирован 5 дн назад

Клиент Vovk.ts для Python — генерация типизированного пакета Python из API Vovk с помощью vovk-python, шаблонов py / pySrc, форм TypedDict, потребления JSON +…

Как процесс C 52/100 · Есть пробелы — слабые места: результат и критерий готовности, входы и предусловия, повторный запуск

ПроцедураРазработкатип и темы размечены автоматически по тексту скилла
JSON
Технический рейтинг
C
84/100
безопасность, качество, тесты
Безопасность 60%
100
Качество 40%
61
Прогон на моделях
не было
Процессный рейтинг
C
52/100
Есть пробелы
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
Отчётность по ходу вес 2
0
три самых слабых из десяти параметров · все десять

Как улучшить

  1. Сократите description до 1024 символов.
Для прогона на моделях — необязательно
  • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
  • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

Находки guard · 0

✓ Критических и высоких находок нет

Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

По спецификации Agent Skills

  • ошибка description-long description 1025 символов, лимит 1024

Процессный рейтинг: все десять параметров 52/100

  • 0Результат и критерий готовности. Не сказано, что считать результатом
  • 0Входы и предусловия. Не сказано, что нужно иметь на входе
  • 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
  • 30Повторный запуск. Изменяющих операций: 5, без проверки текущего состояния
  • 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
  • 60Инструменты и файлы. Используются инструменты (bash, python), но во frontmatter они не объявлены
  • 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
  • 85Шаги. Шагов: 18, расплывчатых формулировок: 1
  • 100Согласованность. Имя и обязательные поля на месте
  • 100Стоимость исполнения. Тело инструкции 2998 токенов
  • low Разделов верхнего уровня: 10. Похоже на несколько доменов в одном скилле

Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.

Сигналы качества

  • +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
  • +3Длина description 1025: рекомендуется 120–800 символов
  • +3Формат ответа не описан: модель каждый раз решает сама
  • +1Лицензия не указана
  • +2Инструкции на одном языке
  • +5В description 7 примера фраз-триггеров в кавычках
  • +4Структура: 23 заголовков
  • +3Пошаговые инструкции: 18 пунктов
  • +4Есть примеры (21 блоков кода)

База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 61.