Значок для авторов

Если ваш скилл прошёл проверку хорошо, покажите это там, где на него смотрят, — в README.

Значок рисуется у нас в момент, когда его открывают, и показывает сегодняшнюю оценку, а не ту, что была в день установки. Это неудобно и это единственный честный вариант: скилл меняется, вместе с ним меняется буква. Зато человек, который видит зелёный значок в вашем README, видит правду, а не снимок из прошлого года.

Как поставить

Найдите свой скилл в рейтинге — на его странице внизу лежит готовая строка для README, отдельно для markdown и для html. Скопируйте и вставьте. Ничего регистрировать и никому писать не нужно.

Что означают цвета

A и B — в файлах не нашлось ни опасных инструкций, ни чужих ключей, текст написан аккуратно. C и D — есть к чему придраться: размытые формулировки, странные команды, брошенная на середине инструкция. Красный — мы этот скилл не рекомендуем и говорим об этом вслух; какая именно строка нас смутила, написано на его странице.

Оценка — про текст скилла, а не про то, гениальна ли идея. Мы читаем файлы: что скилл велит делать агенту, что тянет наружу, чем рискует пользователь. Насколько полезен сам замысел, решает тот, кто ставит.

Если вы ведёте каталог

Значок — для одного скилла. Каталогу удобнее взять букву программно и нарисовать её в своей вёрстке, рядом с кнопкой «установить». Для этого есть три открытых адреса, ключ не нужен:

GET /api/v1/grade?url=https://github.com/owner/repo/tree/main/skills/name — оценка по адресу папки скилла.
GET /api/v1/grade/<source>/<slug> — то же по нашему адресу, он совпадает с адресом карточки.
GET /api/v1/grades/<source> — все скиллы одного каталога списком, по 5000 на страницу.

В ответе буква, состояние (ok, missing_files, not_recommended, unrated), результат песочницы и прогона на моделях, если они были, и ссылка на карточку с подробностями. Ответ можно запрашивать прямо из браузера и держать в кэше пятнадцать минут. Просим одно: ставьте рядом с буквой ссылку на карточку, чтобы человек мог увидеть, за что она поставлена.

Если вы не согласны с оценкой

Напишите нам через форму и скажите, что именно не так. Бывает, что сканер принимает строку из документации по безопасности за настоящую угрозу. Если ошибка наша, мы правим правило — и пересчитываются все скиллы сразу, а не один ваш.