rsyslog_doc — скилл для Claude Code: правила документации rsyslog
Скилл rsyslog_doc для Claude Code приводит страницы rsyslog в .rst к общему виду: оформляет метаданные, summary-блоки и сведения о модулях. Включается при работе с файлами doc/source/**/*.rst.
LGPL-3.0 1 установок ★ 2 348 обновлён 2026-10-29
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a claude-codeЧто делает rsyslog_doc
Скилл срабатывает на файлах doc/source/**/*.rst и приводит страницы rsyslog к одному виду: обязательный блок .. meta:: с описанием и ключевыми словами, вступление в обёртке .. summary-start / .. summary-end — такие куски чище достаются RAG-поиском.
Параметры модулей руками не переписывают: их вставляет директива include из doc/source/reference/parameters/, якоря задаются явно, заготовка страницы лежит в doc/ai/templates/template-module.rst. Рядом с модулем нужен MODULE_METADATA.yaml с полями support_status, maturity_level, primary_contact, last_reviewed, а для встроенных инструментов — tools/MODULE_METADATA.json.
Для правок в doc/source/** положено собирать HTML через ./doc/tools/build-doc-linux.sh --clean --format html --jobs "$(nproc)", а make -j16 json-formatter обновляет базу знаний. Добавили, перенесли или удалили .rst — правьте doc/Makefile.am по правилам скилла rsyslog_doc_dist, иначе расширенная проверка дистрибутива покажет расхождение. Новый пример конфигурации rsyslog отдельно смотрят на безопасность по doc/ai/security_triage_rubric.md.
Какие задачи решает
- добавить страницу модуля с метаданными и явными якорями
- протащить параметры из справочника в текст через
include - обновить
MODULE_METADATA.yamlпри смене статуса поддержки - поймать забытый
doc/Makefile.amпосле переименования.rst - проверить пример конфигурации на открытые листенеры и слабый TLS
Примеры запросов агенту
- Добавь страницу
doc/source/modules/imfile.rst: блок.. meta::, summary-срез и ссылка изindex.rst. - Заполни
MODULE_METADATA.yamlдля этого модуля:support_status,maturity_level,primary_contact,last_reviewed. - Прогони новый пример конфигурации по
doc/ai/security_triage_rubric.mdи собери HTML.
Как установить rsyslog_doc
1Через Skills CLI (Vercel)
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a claude-code2Вручную: положить файлы
~/.claude/skills/rsyslog_doc/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rsyslog_doc/
1Через Skills CLI (Vercel)
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a codex2Вручную: положить файлы
.agents/skills/rsyslog_doc/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a cursor2Вручную: положить файлы
.cursor/skills/rsyslog_doc/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rsyslog/rsyslog .agent/skills/rsyslog_doc2Вручную: положить файлы
.github/skills/rsyslog_doc/SKILL.md1Через Skills CLI (Vercel)
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a gemini-cli2Командой платформы
gemini skills install https://github.com/rsyslog/rsyslog --path .agent/skills/rsyslog_docВручную: положить файлы
.devin/skills/rsyslog_doc/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rsyslog/rsyslog --skill rsyslog_doc -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о rsyslog_doc
Как установить rsyslog_doc в Claude Code?
Выполните npx skills add rsyslog/rsyslog --skill rsyslog_doc -a claude-code, файл скилла окажется в ~/.claude/skills/rsyslog_doc/SKILL.md.
Что делает rsyslog_doc?
Задаёт формат страниц документации rsyslog: метаданные, summary-блоки, ссылки, метаданные модулей и набор команд проверки.
Что нужно, кроме самого файла скилла?
Шаблон страницы doc/ai/templates/template-module.rst, список терминов doc/ai/terminology.md и промпт ai/rsyslog_doc_assistant/base_prompt.txt лежат в репозитории rsyslog, поэтому работать он будет в его клоне.