s-skillgate
Pre-publish gate для навыков Skills Hub: секреты + денилист внутренней инфы + валидация манифеста (zero-deps Python)
Что это
«Охранник» (pre-publish gate), который проверяет папку навыка перед публикацией на три вещи:
- Секреты/токены —
glpat-,ghp_,sk-,AKIA, JWT, приватные ключи, DSN с паролем. - Внутренняя инфа — локальные пути, публичные IP (warn) + собственная конкретика через приватный оверлей.
- Структура/манифест — обязательные поля
SKILL.md, инвариант «tooling ⇒ есть cli/mcp», совпадение объявленногоnameс именем каталога навыка.
Возвращает вердикт ok / warn / fail и exit-code 0/1/2. Zero-deps, только stdlib Python ≥3.11 — работает везде, включая Windows без установки бинарей.
Установка
pip install s-skillgate
# или без установки:
uvx --from s-skillgate skillgate run path/to/skill
Запуск
skillgate run path/to/skill # человекочитаемо
skillgate run path/to/skill --json # машинно; exit 0 ok / 1 warn / 2 fail
skillgate sweep # прогон по ~/.claude/skills: имя ≠ каталог
skillgate sweep <dir> --json --all # свой каталог навыков, машинно, со всеми
Имя навыка против каталога
Объявленное во фронтматтере name обязано совпадать с именем каталога. Расхождение
не ломает вызов (резолвер ключует по каталогу), но канал установки читает именно
name — навык встаёт под чужим slug, а ссылки на него ведут в пустоту. Поэтому
уровень fail, и вердикт называет обе стороны: «каталог graphify, объявлено
graphify-windows». sweep показывает такие расхождения по всему каталогу навыков
списком, заодно называя каталоги без SKILL.md. junction не разыменовывается —
имя навыка это имя точки монтирования. Плагинный навык (короткое name, а форму
plugin:skill собирает харнесс) ложной тревоги не даёт.
Как библиотека:
from skillgate import run_gate, sweep_skills
report = run_gate("path/to/skill")
print(report.verdict, report.exit_code)
for entry in sweep_skills(): # по умолчанию ~/.claude/skills
if not entry.ok:
print(entry.directory, [f.message for f in entry.findings])
Правила
- Общие паттерны (токены, пути, IP) —
src/skillgate/data/denylist.toml. Один файл, формат TOML, regex в literal-строках (одинарные кавычки). Дописал[[rule]]— правило работает. - Исключения/заглушки (публичные домены-примеры,
__set_me__, RFC1918) —src/skillgate/data/allowlist.toml. Если совпадение попало под allowlist — находка гасится. - Приватная конкретика (реальные IP серверов, имена приватных git-групп, внутренние домены) — НЕ в публичном пакете. Скопируй
data/denylist.local.example.toml→data/denylist.local.toml(он в.gitignore) и впиши свои значения;run_gateподхватит оверлей автоматически.
Правила покрыты golden-тестами (tests/golden/): must_match.txt (обязано ловиться) / must_not_match.txt (легальные заглушки). Менять правило → добавить кейс.
Тесты
uv run --with pytest pytest -q
License
MIT
Metadata
Release files for s-skillgate 0.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| s_skillgate-0.1.7.tar.gz | 34.1 kB | Without provenance | Details for s_skillgate-0.1.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| s_skillgate-0.1.7-py3-none-any.whl | Python 3 | none | any | Details for s_skillgate-0.1.7-py3-none-any.whl |
Total release size: 58.6 kB
Release files / s_skillgate-0.1.7.tar.gz
| Download URL | s_skillgate-0.1.7.tar.gz |
|---|---|
| Size | 34.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6d3c0749dc250727bd131d06e1ede141a7232d09773baa8a51ae71fcab88a5bc
|
|
BLAKE2b-256 checksum How to use checksums |
de97f04eacf942ec8d89e8f7b454adc55affa80eb22573397467f361bd22cfdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / s_skillgate-0.1.7-py3-none-any.whl
| Download URL | s_skillgate-0.1.7-py3-none-any.whl |
|---|---|
| Size | 24.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a5e202c40812d7627be93c308f4506b48c55e937bd66e4295a83481f5f52f600
|
|
BLAKE2b-256 checksum How to use checksums |
74283bbc48cb13c6881a3c673381d8bdda176dba75246b4e4af90023f2e69eff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for s-skillgate 0.1.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.