К основному содержанию
скилл CX Codex официальный · GitHub

skill-distribution-audit — скилл для GitHub Copilot

Скилл skill-distribution-audit для GitHub Copilot проверяет репозитории со скиллами перед релизом. Сверяет исходные файлы с манифестом дистрибуции и реальной поисковой выдачей клиента.

MIT ★ 41 430 обновлён 2026-10-23

Установить в GitHub Copilot · GitHub CLI Все способы и платформы ↓
gh skill install github/awesome-copilot skills/skill-distribution-audit
Открыть на GitHub

Что делает skill-distribution-audit

Скилл сопоставляет каталог исходников с правилами публикации и выводом клиентской команды обнаружения. Он находит забытые при сборке скиллы, утечки архивных файлов или шаблонов, дубликаты идентификаторов и расхождения в манифестах. Проверка учитывает правила конкретной версии клиента, а не только локальный синтаксис YAML.

Внутрь встроен детерминированный скрипт scripts/compare-discovery.mjs, которому нужен Node.js 20 или новее. Скрипт принимает два JSON-файла со списками точных идентификаторов и возвращает отчёт с подсчётом несовпадений. Запуск не требует сторонних npm-пакетов.

Тела скиллов при аудите намеренно не исполняются. Успешная сверка гарантирует только корректность состава дистрибуции, но не проверяет загрузку скриптов в живой сессии агента или доступность внешних API.

Какие задачи решает

  • найти пропущенные файлы скиллов перед публикацией релиза
  • выявить попадание тестовых фикстур и шаблонов в итоговый манифест
  • обнаружить конфликтующие дубликаты идентификаторов в каталоге
  • сравнить ожидаемый список скиллов с реальным выводом установщика

Примеры запросов агенту

  • Проверь коллекцию скиллов перед релизом и сравни исходники с текущим манифестом
  • Найди расхождения между манифестом дистрибуции и фактическим выводом команды discovery
  • Запусти аудит идентификаторов и покажи дубликаты среди опубликованных скиллов

Как установить skill-distribution-audit

1GitHub CLI

gh skill install github/awesome-copilot skills/skill-distribution-audit

2Вручную: положить файлы

.github/skills/skill-distribution-audit/SKILL.md

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о skill-distribution-audit

Как установить skill-distribution-audit в GitHub Copilot?

Выполните команду gh skill install github/awesome-copilot skills/skill-distribution-audit.

Что делает skill-distribution-audit?

Сверяет исходный набор скиллов в репозитории с манифестом публикации и списком установщика, выявляя пропуски, утечки шаблонов и дублирующиеся имена.

Что нужно для работы вспомогательного скрипта сравнения?

Для запуска встроенного scripts/compare-discovery.mjs требуется установленный Node.js версии 20 или выше. Сторонние библиотеки не нужны.

Исходный текст

SKILL.md · MIT
---
name: skill-distribution-audit
description: "Audit a skill collection before release or investigate installer omissions, archived/template leakage, duplicate identities, and manifest drift. Reconcile the intended public source set, distribution manifest, and actual discovery output for a specified consumer version. Includes a deterministic set-comparison helper."
---

# Skill Distribution Audit

Give a collection maintainer a release-correctness report: which intended skills are missing, which unintended entries are exposed, and which identities are ambiguous. Start from the source revision and target consumer, rather than assuming that a readable SKILL.md will be distributed correctly.

## Establish the distribution contract

Record the source revision, consumer/client and version, distribution layout, and requested scope. If a client-specific rule affects the result, consult that consumer's documentation or implementation; otherwise leave the conclusion unverified.

Build the intended public set from the repository's actual release policy and source files. Distinguish active skills from archives, templates, test fixtures, generated copies, and internal maintenance content. A source collection can contain SKILL.md files that it deliberately does not publish. An existing manifest may itself be stale, so do not use it as the only source of truth.

Keep a mapping from each identity to its source path. Prefer repository-relative paths when both sides expose them; use names only when unique and comparable. If discovery returns names that map to multiple source paths, report the ambiguity rather than silently choosing or deduplicating an entry.

## Collect comparable evidence

- Parse frontmatter with a standard YAML parser compatible with the target consumer, then validate its supported field types. Separate malformed YAML from valid YAML that fails the consumer's schema. A repository's custom parser passing is not proof of consumer compatibility.
- Inspect the actual release/manifest rules, including path bases, explicit entries, globs, and exclusion or internal flags. Apply only the target version's semantics: a repository's deprecated status field does not necessarily hide an entry from an installer.
- Obtain the consumer's discovery/list output for the same source revision when an appropriate command is available and authorized. Inspect its behavior first; a command named list is not automatically free of downloads or writes. Prefer an isolated checkout and retain stderr, exit status, version, source revision, and completeness/pagination limits.
- Use existing captured output when a fresh consumer run is unavailable. Mark it as historical. If no comparable consumer output is available, complete the static checks and state that discovery coverage remains unverified.

Do not execute skill bodies or their helpers while collecting distribution evidence. Installation and end-to-end task execution are separate validation scopes; do not repeat installations to manufacture usage counts.

## Reconcile identities, not just totals

Compare the intended public set against the manifest and against observed discovery separately, when those layers exist. Report missing identities, unexpected identities, duplicates, and parse failures independently. Also compare the manifest to discovery when it is the actual consumer input. Do not assume that a manifest for a different installer controls a direct repository scan.

Equal totals can conceal different identities. For example, an intended set of two active skills and an observed set containing one active skill plus one template both have length two, yet contain one omission and one leak.

For deterministic comparisons, use the bundled [compare-discovery.mjs](scripts/compare-discovery.mjs) with Node.js 20 or later; it needs no third-party packages. It accepts two JSON arrays of exact identity strings. Create those inputs from the evidence above; it does not discover skills or infer release policy.

```sh
node <skill-directory>/scripts/compare-discovery.mjs <expected.json> <observed.json>
```

The JSON report includes raw/unique counts, missing and unexpected identities, and duplicate counts on both sides. Exit codes: 0 for an exact unique match, 1 for mismatches or duplicates, 2 for invalid input or an I/O error. It reads the supplied files and writes only its report; it never invokes an installer.

See the [worked example](references/worked-example.md) for sample inputs and an auditable report. The helper's regression tests run with:

```sh
node --test <skill-directory>/scripts/compare-discovery.test.mjs
```

For a recorded Copilot run on real historical captures, including exact inputs, helper output, and a local replay command, see the [Copilot validation report](references/copilot-real-data-validation.md). Read it when validating or reproducing this skill; it is not required for an ordinary audit.

## Report and repair

For each finding, give the affected identities, source/configuration paths and line numbers, observed behavior, likely cause, and smallest repair. Distinguish direct observations from inferences. Avoid changing skill bodies when a metadata or manifest correction is sufficient; preserve unrelated metadata and licensing.

Include the source revision, consumer version, expected/manifest/discovered counts, exact differences, checks actually run, and verification limits. Allow zero findings. Do not turn unavailable or truncated discovery into a successful match by comparing only a convenient subset.

An exact discovery match establishes distribution coverage within the audited scope. It does not establish that skills are loaded by a live Copilot session, that packaged helpers work, or that credentials and external services are usable. After an authorized repair, repeat the relevant parsing and reconciliation checks on the repaired revision and report what changed.

© github · MIT · github/awesome-copilot

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
openclaw-audit-watchdog prompt-security Скилл openclaw-audit-watchdog запускает глубокий аудит безопасности агентов OpenClaw по расписанию и присылает отчёт в личные сообщения. Почту можно подключить отдельно. CX Codex +1 756установок seo-audit seomator Скилл seo-audit для Claude Code проверяет SEO, техническое состояние, безопасность и готовность сайта к AI-поиску. Запускает SEOmator CLI для аудита страниц и сравнения результатов до и после изменений. CX Codex +1 1 200установок review-plugin-submission cursor Скилл review-plugin-submission для Claude Code проверяет готовность плагина Cursor к публикации в маркетплейсе. Проверяет манифест, метаданные компонентов, пути обнаружения и документацию, выдаёт проблемы с приоритетами. CX Codex +1 1 200установок audit-verify-explain-grade-5 MengTo Скилл audit-verify-explain-grade-5 для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который проверяет изменения с опорой на реальные доказательства и объясняет результат простым языком. CX Codex +1 1 700установок nielsen-heuristics-audit mastepanoski Скилл nielsen-heuristics-audit для Claude Code прогоняет интерфейс по 10 эвристикам Нильсена и выдаёт отчёт с оценкой серьёзности каждой находки — до тестов с людьми. CX Codex +1 824установок dependencies-audit cognitedata Скилл dependencies-audit находит уязвимости, устаревшие и заброшенные пакеты, проблемы с лицензиями и чинит их, а не просто составляет отчёт. CX Codex +1 1 900установок

Из того же набора993

Весь набор →
supabase-rls-policies Скилл supabase-rls-policies для GitHub Copilot помогает писать, проверять и тестировать политики Row Level Security в Supabase. Запускается при создании таблиц, правке миграций и настройке изоляции пользователей. CX Codex +1 ★ 41 430звёзд репо spring-security Помогает настраивать, тестировать и проверять Spring Security. Подключается при добавлении или аудите аутентификации и авторизации в приложении Spring Boot. CX Codex +1 ★ 41 430звёзд репо spring-observability Скилл spring-observability для GitHub Copilot настраивает наблюдаемость в сервисах на Spring Boot 3 и 4. Включается при добавлении метрик Micrometer, трассировки OpenTelemetry и структурированных логов с Actuator. CX Codex +1 ★ 41 430звёзд репо spring-boot-4-migration Скилл spring-boot-4-migration для GitHub Copilot переносит приложение со Spring Boot 3.x на 4.0. Запускается для миграции, разбора вызванных ею ошибок сборки и тестов или проверки уже выполненного перехода. CX Codex +1 ★ 41 430звёзд репо scout-issue Скилл scout-issue для GitHub Copilot подбирает GitHub issues для вклада в открытые проекты. Он спрашивает об опыте, навыках, времени и типе вклада, затем ранжирует подходящие задачи. CX Codex +1 ★ 41 430звёзд репо sap-cloud-integration Помогает писать и разбирать iFlow в SAP Cloud Integration. Срабатывает при работе с CPI-скриптами Groovy, настройками обмена и ошибками адаптеров. CX Codex +1 ★ 41 430звёзд репо pr-artifact-explorer Скилл pr-artifact-explorer для GitHub Copilot открывает GitHub PR, issues, запуски workflow, Actions-артефакты и веб-превью в общей панели. Он включается по запросу показать или изучить эти материалы. CX Codex +1 ★ 41 430звёзд репо ponder Скилл ponder для GitHub Copilot запускает цикл повторных проходов оценки проекта, пока выводы модели не перестанут меняться. Проверяет полное покрытие всех модулей без пропуска файлов. CX Codex +1 ★ 41 430звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой