Навыки docs-validator
📦

docs-validator

Ревизия содержимого r2 Средний риск ⚙️ Внешние команды🌐 Доступ к сети📁 Доступ к файловой системе

Проверка качества документации

Документация может расходиться с актуальным состоянием по мере изменения файлов, ссылок, примеров и модулей. Этот навык проводит Claude, Codex и Claude Code через структурированную проверку.

Поддерживает: Claude Codex Code(CC)
📊 69 Адекватно

Установить с помощью моего Агента

Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.

Запрос агента
Review the Skillstore skill "docs-validator" from https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator.md and its manifest at https://skillstore.io/api/skills/c0ntr0lledcha0s-docs-validator/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.

Ресурсы для AI-агентов

Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.

Протестировать

Использование «docs-validator». Проверь документацию.

Ожидаемый результат:

Общий статус: хорошо. Основные проблемы: один отсутствующий README модуля, одна битая ссылка установки и два блока кода без языковых меток.

Использование «docs-validator». Проверь наличие битых ссылок.

Ожидаемый результат:

Найдена одна битая внешняя ссылка и одна отсутствующая внутренняя цель. Предложенные исправления включают заменяющий URL загрузки и исправленный путь к руководству по настройке.

Использование «docs-validator». Проверь покрытие документации модулей.

Ожидаемый результат:

Покрытие README модулей в основном полное. Самый приоритетный пробел — крупнейший недокументированный модуль, затем идут неполные примеры.

Аудит безопасности

Средний риск

All 42 static findings are false positives caused by Markdown fences, safe read-only shell examples, placeholder URLs, a relative link, and checklist prose. Semantic review identified two medium risks: unrestricted external URL testing and optional execution of documentation examples without explicit isolation controls.

1
Просканировано файлов
519
Проанализировано строк
0
Пункты проверки
0
Ложные срабатывания проигнорированы

Подтверждённые проблемы безопасности (2)

Средний
Unrestricted External URL Validation
The workflow directs the agent to test repository-controlled external links. Without destination filtering, links could target loopback, private networks, or cloud metadata services.
The skill explicitly says to test extracted URLs and identifies Bash for URL testing. The risk depends on repository content and missing destination controls.
Средний
Execution of Repository-Controlled Examples
The workflow permits testing commands and code examples found in documentation. Executing untrusted examples could modify files, expose data, or launch external processes.
The text explicitly calls for testing commands and code examples, although one section adds an if-safe qualifier. No sandbox or approval requirement is defined.
Поделиться и цитировать этот отчет

Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.

Открыть версионный отчет
Оценка безопасности

Копировать ссылку на отчёт

https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Значок Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/c0ntr0lledcha0s-docs-validator/security.svg)](https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator?utm_source=security_passport_badge)

Значок HTML

<a href="https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/c0ntr0lledcha0s-docs-validator/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Встраиваемая карточка

<iframe src="https://skillstore.io/embed/skills/c0ntr0lledcha0s-docs-validator.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Академические ссылки (APA · BibTeX · CFF)

Цитата APA

C0ntr0lledCha0s. (2026). docs-validator security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9

Цитата BibTeX

@techreport{c0ntr0lledcha0s-c0ntr0lledcha0s-docs-validator-2026, author = {C0ntr0lledCha0s}, title = {docs-validator security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "docs-validator security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "C0ntr0lledCha0s" date-released: "2026-07-23" url: "https://skillstore.io/skills/c0ntr0lledcha0s-docs-validator/audits/9" identifiers: - type: other value: "skillstore:c0ntr0lledcha0s-docs-validator:audit:9" description: "Skillstore immutable audit report identifier"

Оценка Skillstore

Почему такая оценка Достоверность доказательств: Высокий
55
Архитектура
85
Сопровождаемость
87
Контент
71
Сообщество
87
Соответствие спецификации

Что вы можете построить

Подготовить документацию к релизу

Проверьте руководства, README модулей, ссылки и примеры перед финализацией релизной ветки.

Проверить покрытие модулей

Выявите отсутствующие файлы README и слабые объяснения модулей по всему дереву исходного кода.

Проверить качество документации

Найдите проблемы форматирования, терминологии и устаревших статусов во время регулярного сопровождения документации.

Попробуйте эти промпты

Запустить быструю проверку
Проверь документацию в этом репозитории. Сообщи о главных проблемах, затронутых файлах и быстрых исправлениях.
Проверить ссылки
Проверь ссылки в документации. Раздели внутренние и внешние ссылки, сообщи о битых целях и предложи исправленные назначения.
Измерить покрытие модулей
Проведи аудит покрытия документации модулей. Перечисли модули с отсутствующими или слабыми файлами README и ранжируй исправления по влиянию.
Запустить полный аудит документации
Запусти полный аудит документации на полноту, точность, форматирование, ссылки, покрытие и согласованность. Дай приоритизированные рекомендации.

Лучшие практики

  • Запускайте быстрые проверки перед небольшими правками документации и полные аудиты перед релизами.
  • Проверяйте предлагаемые shell- или сетевые проверки перед их выполнением в репозитории.
  • Сначала приоритизируйте битые ссылки, отсутствующую документацию основных модулей и неточные команды.

Избегать

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

Часто задаваемые вопросы

Какую документацию проверяет этот навык?
Он проверяет руководства Logseq Template Graph, README модулей, документацию команд, документацию навыков, ссылки, примеры и форматирование.
Может ли он находить битые ссылки?
Да. Он направляет агента на разделение внутренних и внешних ссылок, проверку целей и предложение исправлений.
Требуется ли ему доступ к сети?
Доступ к сети нужен только для проверок внешних URL. Локальные проверки документации могут выполняться без доступа к сети.
Будет ли он автоматически редактировать документацию?
Нет. Навык предназначен для сообщения о проблемах и исправлениях, если пользователь не попросит внести правки.
Могут ли Claude, Codex и Claude Code использовать его?
Да. В отчете указана поддержка Claude, Codex и Claude Code.
Он ограничен одним репозиторием?
Его чеклист специфичен для Logseq Template Graph, но многие категории проверки применимы к похожим Markdown-проектам.

Сведения для разработчиков

Автор

C0ntr0lledCha0s

Лицензия

MIT

Ревизия Skillstore

r2

Примечание о версии

Автор не указал версию.

Ссылка

a39a91716eadede5f4cdefd78178fed4e837a128

Актуальность поддержки

27.07.2026

Использование

6 загрузок · 236 просмотров

Структура файлов

📄 SKILL.md

Больше от C0ntr0lledCha0s

Показать все
📦

analyzing-test-quality

87

Анализ качества тестов в разных фреймворках

Слабые тесты скрывают дефекты, замедляют рефакторинг и делают показатели покрытия вводящими в заблуждение. Этот навык анализирует тестовые наборы и дает приоритетные рекомендации по надежности, сопровождаемости, покрытию и мутационному тестированию.

Кодинг и разработка Просмотр
📦

jest-testing

86

Создание надежных наборов тестов Jest

Проектам Jest часто нужны единообразные паттерны настройки, мокирования и проверок. Этот навык дает сфокусированные рекомендации, шаблоны и проверки для тестов JavaScript, TypeScript, React и тестов в стиле Vitest.

Кодинг и разработка Просмотр
📦

analyzing-patterns

86

Анализ паттернов кода и архитектуры

В больших кодовых базах скрываются повторяющиеся структуры и неочевидные архитектурные решения. Этот навык находит паттерны, объясняет их назначение и выделяет практические возможности для рефакторинга.

Кодинг и разработка Просмотр
📦

playwright-testing

86

Улучшение покрытия тестами Playwright

Наборы тестов Playwright могут становиться нестабильными, когда конфигурация, локаторы и фикстуры непоследовательны. Этот навык дает практические шаблоны для надежных браузерных тестов, отладки и переиспользуемых page objects.

Кодинг и разработка Просмотр
📦

organizing-with-labels

86

Организация GitHub Issues с помощью меток

Крупные репозитории теряют время, когда в issues используются несогласованные метки и неясные milestones. Этот skill помогает создавать таксономии, выполнять массовые обновления и отслеживать прогресс через GitHub workflows.

Продуктивность Просмотр
📦

building-agents

85

Создавайте агентов Claude Code

Создание надежных ИИ-агентов требует четких схем, безопасных инструментов и повторяемых этапов проверки. Этот навык помогает проектировать, проверять, мигрировать и поддерживать агентов для рабочих процессов Claude Code.

Кодинг и разработка Просмотр
Показать все
📦

project-planner

86

Планируйте программные проекты с помощью структурированных документов

от Dwsy

Программные проекты часто терпят неудачу, когда требования, проектные решения и задачи неясны. Этот навык превращает идеи проектов в структурированные плановые документы для рабочих процессов Claude, Codex и Claude Code.

Документация Просмотр
📦

github-release-assistant

83

Генерация двуязычной документации для релизов GitHub

от ZhanlinCui

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

Документация Просмотр
📦

skill-creation-guide

81

Создание эффективных ИИ-навыков

от notedit

Командам нужны воспроизводимые рекомендации для создания полезных ИИ-навыков без добавления ненужного контекста. Этот навык предоставляет структурированный процесс для планирования, написания, проверки и упаковки навыков.

Документация Просмотр