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.
Скилл учит ИИ генерировать типизированный Python-клиент из Vovk API через vovk-python и шаблоны py/pySrc. Обещает TypedDict, валидацию на клиенте, поддержку JSON Lines и публикацию на PyPI.
Файл один, описание обрезано (lint ругается на длину). Проверок на моделях не было, песочницы нет. Оценка C: quality 61, process 52 — скилл работает, но инструкция неполная. Критических проблем не найдено, но medium/low findings не указаны явно.
Ставить можно, если вам нужен именно Vovk-клиент и вы готовы дополнить инструкцию сами. На моделях не тестировалось, поэтому первый запуск — лотерея.
Клиент Vovk.ts для Python — генерация типизированного пакета Python из API Vovk с помощью vovk-python, шаблонов py / pySrc, форм TypedDict, потребления JSON +…
Как процесс C 52/100 · Есть пробелы — слабые места: результат и критерий готовности, входы и предусловия, повторный запуск
Как улучшить
- Сократите description до 1024 символов.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 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.