AC puzle-read-skill
Подключитесь к Puzle Read — интеллектуальной рабочей среде для чтения, которая помогает пользователям превращать статьи и документы в личные знания с возможностью поиска. Сохраняйте веб-статьи (по URL или предварительно полученному контенту), загружайте документы и файлы в библиотеку чтения пользователя и ищите по всему, что он прочитал, чтобы найти релевантные идеи. Используйте этот навык всякий раз, когда пользователь хочет: сохранить или прочитать веб-статьи, добавить документы в свою библиотеку чтения, найти что-то из своей коллекции чтения, обработать PDF или другие файлы для более глубокого понимания или построить рабочие процессы знаний вокруг своих чтений. Этот навык также применяется, когда пользователь хочет: сохранить что-то для последующего чтения ("прочитать позже", "добавить в закладки", "сохранить эту статью"), получить сводку или анализ статьи или документа, загрузить файл (PDF, изображение, аудио и т. д.) для обработки или организовать свою коллекцию чтения. Также запускайте, когда вы видите импорт `puzle_reading` или `PuzleReadingClient`, или когда пользователь упоминает Puzle.
машинный переводПоказать оригиналСкрыть оригинал«Connect to Puzle Read — an intelligent reading workbench that helps us…»
Connect to Puzle Read — an intelligent reading workbench that helps users turn articles and documents into searchable personal knowledge. Save web articles (by URL or pre-fetched content), upload documents and files to the user's reading library, and search across everything they've read to find relevant insights. Use this skill whenever the user wants to: save or read web articles, add documents to their reading library, look up something from their reading collection, process PDFs or other files for deeper understanding, or build knowledge workflows around their readings. This skill also applies when the user wants to: save something for later reading ("read it later", "bookmark this", "save this article"), get a summary or analysis of an article or document, upload a file (PDF, image, audio, etc.) for processing, or organize their reading collection. Also trigger when you see imports of `puzle_reading` or `PuzleReadingClient`, or when the user mentions Puzle.
Подключитесь к Puzle Read — интеллектуальной рабочей среде для чтения, которая помогает пользователям превращать статьи и документы в личные знания с…
Как процесс C 63/100 · Есть пробелы — слабые места: результат и критерий готовности, согласованность
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Инструкции или скрипты отправляют данные наружу: переменные окружения, ключи, содержимое файлов, историю чата. Вы можете не заметить этого в диалоге, потому что агент выполнит отправку как «часть задачи».
Если отправка не нужна для задачи, уберите её: каталоги помечают такие скиллы как подозрительные и снимают с выдачи. Если нужна, назовите адрес явно, объясните, что именно уходит, и дайте пользователю выключатель.
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 1
✓ Критических и высоких находок нет
Средние и низкие: 1
-
средняя Утечка данных
net-redirectable-api-keyscripts/puzle_reading.py:79Скрипт отправляет API-ключ на хост из переменной окружения — ключ можно перенаправить на другой серверAPI key + configurable base URL from environment
Просканировано файлов: 3. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
✓ По спецификации Agent Skills замечаний нет
Процессный рейтинг: все десять параметров 63/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 40Согласованность. Имя во frontmatter (puzle-read-skill) не совпадает с папкой (puzle-read)
- 60Инструменты и файлы. Используются инструменты (bash, web), но во frontmatter они не объявлены
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Входы и предусловия. Входные данные и предусловия перечислены
- 70Стоимость исполнения. Тело инструкции 4559 токенов
- 85Шаги. Шагов: 39, расплывчатых формулировок: 1
- 100Ошибки и развилки. Развилок: 3, есть раздел про ошибки
- 100Повторный запуск. Изменяющие операции проверяют текущее состояние
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- low Разделов верхнего уровня: 10. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 976: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 3 примера фраз-триггеров в кавычках
- +4Структура: 37 заголовков
- +3Пошаговые инструкции: 39 пунктов
- +4Есть примеры (23 блоков кода)
- +3Все 1 скриптов описаны в инструкциях
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 89.