CF clio
Интеграция с API Clio с управляемым OAuth. Это интеграция с возможностью записи — она может читать, создавать, обновлять и удалять данные юридической практики, включая дела, контакты, действия, задачи, документы, записи календаря, записи времени и выставление счетов. Используйте этот навык, когда пользователи хотят взаимодействовать с данными юридической практики в Clio Manage. Все операции записи (создание/обновление/удаление дел, контактов, выставление счетов) требуют явного одобрения пользователя с указанием конкретных идентификаторов ресурсов перед выполнением. Для других сторонних приложений используйте навык api-gateway (https://clawhub.ai/byungkyu/api-gateway). Вызовы выполняются через CLI `maton` после `maton login --oauth`. Учетные данные Clio остаются в шлюзе и никогда не обрабатываются локально; единственные учетные данные, используемые локально, — это собственные учетные данные Maton пользователя — хранящиеся в CLI или предоставленные в качестве `MATON_API_KEY` в качестве резервного варианта и внедряемые во время выполнения в любую размещенную функцию, которую развертывает пользователь. Как и каждый навык Maton, этот файл также содержит разделы платформы, идентичные разделам api-gateway — запланированные и событийные триггеры, назначения и размещенные функции, чтобы задача Clio, требующая расписания или шага, управляемого событиями, имела необходимые правила. Они не добавляют функциональности Clio: Clio не является источником событий, триггер не может читать данные Clio, а файлы в разделе `references/<source>/triggers.md` являются каталогами событий платформы для источников, предлагаемых Maton (время, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe), для использования только тогда, когда пользователь подключил этот источник и запрашивает реакцию на его события. По умолчанию выполняйте вызовы чтения и списка, оставайтесь в конечных точках, документированных этим навыком, и подтверждайте каждую запись или новое соединение с пользователем.
машинный переводПоказать оригиналСкрыть оригинал«Clio API integration with managed OAuth. This is a write-capable integ…»
Clio API integration with managed OAuth. This is a write-capable integration — it can read, create, update, and delete legal practice data including matters, contacts, activities, tasks, documents, calendar entries, time entries, and billing. Use this skill when users want to interact with legal practice data in Clio Manage. All write operations (creating/updating/deleting matters, contacts, billing) require explicit user approval with specific resource identifiers before execution. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI after `maton login --oauth`. The Clio credential stays in the gateway and is never handled locally; the only credential used locally is the user's own Maton one - held by the CLI, or supplied as `MATON_API_KEY` in the appendix fallback and injected at runtime into any hosted function the user deploys. Like every Maton skill, this file also carries the platform sections shared verbatim with the api-gateway skill - scheduled and event triggers, destinations, and hosted functions - so that a Clio task that needs a schedule or an event-driven step has the rules at hand. They add no Clio capability: Clio is not an event source, a trigger cannot read Clio data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe), for use only when the user has connected that source and asks to react to its events. Default to read and list calls, stay on the endpoints this skill documents, and confirm every write or new connection with the user.
Интеграция с API Clio с управляемым OAuth.
Как процесс F 59/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: references/<source>/triggers.md, references/{source}/triggers.md
Чем это грозит
Находки средней серьёзности: скорее всего скилл честный, но прочитайте, что именно насторожило сканер.
Ниже описан худший случай для этой категории. Здесь находка средней серьёзности: guard увидел признак, но не доказательство.
Скилл просит больше прав, чем нужно для задачи: широкий доступ к инструментам, секретные переменные окружения, бинарные файлы. Каждое лишнее право расширяет ущерб при ошибке или взломе.
Сузьте allowed-tools и список переменных до минимума, замените бинарники на исходники или скрипты, которые можно прочитать.
Как улучшить
- Сократите description до 1024 символов.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 11
✓ Критических и высоких находок нет
Средние и низкие: 11
-
средняя Широкие права
meta-broad-allowed-toolsSKILL.md:1Заранее разрешены широкие инструменты: Bashallowed-tools: Bash Read Grep Glob
-
низкая Секреты в коде
secret-high-entropy-tokenreferences/github/triggers.md:1139Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"node_id": "MDIz…DU3"
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/github/triggers.md:1313Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"node_id": "MDEw…jY5",
в кавычках -
низкая Обфускация
obf-base64-blobreferences/slack/triggers.md:73Длинный blob, похожий на base64 (в кавычках — упоминание, а не команда)"event_context": "4-ey…ifQ",
в кавычках -
низкая Обфускация
obf-base64-blobreferences/slack/triggers.md:133Длинный blob, похожий на base64 (в кавычках — упоминание, а не команда)"event_context": "4-ey…ifQ",
в кавычках -
низкая Обфускация
obf-base64-blobreferences/slack/triggers.md:179Длинный blob, похожий на base64 (в кавычках — упоминание, а не команда)"event_context": "4-ey…In0",
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/stripe/triggers.md:41Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"balance_transaction": "txn_…GxW",
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/stripe/triggers.md:117Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"id": "evt_…qVg",
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/stripe/triggers.md:144Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"subscription": "sub_…qSY"
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/stripe/triggers.md:180Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"subscription": "sub_…qSY",
в кавычках -
низкая Секреты в коде
secret-high-entropy-tokenreferences/stripe/triggers.md:194Строка, похожая на токен (может быть id, хеш или секрет) (в кавычках — упоминание, а не команда)"subscription": "sub_…qSY",
в кавычках
Просканировано файлов: 11. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1694 символов, лимит 1024 - предупреждение
body-longтело SKILL.md ≈ 13860 токенов (рекомендуется < 5000); вынесите детали в references/ - предупреждение
missing-refссылка на отсутствующий файл: references/<source>/triggers.md - предупреждение
missing-refссылка на отсутствующий файл: references/{source}/triggers.md - заметка
description-budgetdescription занимает 1694 из общего бюджета ~15000 символов на все скиллы - заметка
edit-residueв тексте есть пометки об устаревшем (строки 661): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия
Процессный рейтинг: все десять параметров 59/100
- 0Инструменты и файлы. Не хватает 2 файла(ов): references/<source>/triggers.md, references/{source}/triggers.md
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 30Повторный запуск. Изменяющих операций: 108, без проверки текущего состояния
- 40Стоимость исполнения. Тело инструкции 13860 токенов: вытесняет саму задачу из окна
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 100Шаги. Шагов: 74
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 4, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Отчётность по ходу. Скилл сообщает о ходе работы
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Разделов верхнего уровня: 14. Похоже на несколько доменов в одном скилле
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1693: рекомендуется 120–800 символов
- +1Лицензия не указана
- +2Инструкции на одном языке
- +4Структура: 115 заголовков
- +3Пошаговые инструкции: 74 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (116 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 37.