role-info — Claude Code skill: what it does, how to install
Parses 1C Rights.xml role files into a concise summary of granted permissions, RLS rules, and restriction templates.
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat role-info does
The skill reads a 1C role file (Rights.xml) and organizes metadata objects by type. Instead of processing thousands of XML lines, the agent receives 50 to 150 lines detailing allowed actions, RLS conditions, and restriction templates. The -ShowDenied flag exposes denied rights when needed.
Execution relies on PowerShell running role-info.ps1. The script must write output to a file using -OutFile, because raw bash console pipes corrupt Cyrillic text. Pagination parameters -Limit and -Offset handle oversized roles by splitting output into chunks.
What it helps with
- inspect 1C role permissions from Rights.xml
- verify RLS rules and restriction templates
- condense thousands of XML lines into a short summary
- list granted rights by metadata object type
Example prompts for the agent
- Summarize permissions using /role-info Roles/Accountant/Ext/Rights.xml
- /role-info Roles/SalesManager/Ext/Rights.xml
- Check RLS restrictions with /role-info Roles/Warehouse/Ext/Rights.xml
How to install role-info
1Plugin marketplace
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills/plugin install 1c-skills@cc-1c-skillsThis installs the whole 1c-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-info -a claude-code3Manually: put the files in place
~/.claude/skills/role-info/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/role-info/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-info -a codex2Manually: put the files in place
.agents/skills/role-info/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/role-info/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills role-info2Manually: put the files in place
.github/skills/role-info/SKILL.mdPlatform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/role-infoManually: put the files in place
.devin/skills/role-info/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about role-info
How to install role-info in Claude Code?
Run both commands sequentially: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills and /plugin install 1c-skills@cc-1c-skills.
What does role-info do?
It parses 1C Rights.xml role definitions into a concise summary of permitted objects, actions, and RLS restrictions.
Why does the script require OutFile?
Direct PowerShell console output in bash breaks Cyrillic characters. The -OutFile argument writes a clean UTF-8 BOM file that the agent reads via the Read tool.
Source text
SKILL.md · MIT
---
name: role-info
description: Компактная сводка прав роли 1С из Rights.xml — объекты, права, RLS, шаблоны ограничений. Используй для аудита прав — какие объекты и действия доступны, ограничения RLS
argument-hint: <RightsPath>
allowed-tools:
- Bash
- Read
---
# /role-info — анализ роли 1С
Парсит `Rights.xml` роли и выдаёт компактную сводку: объекты сгруппированы по типу, показаны только разрешённые права. Сжатие: тысячи строк XML → 50–150 строк текста.
## Использование
```
/role-info <RightsPath>
```
**RightsPath** — путь к файлу `Rights.xml` роли (обычно `Roles/ИмяРоли/Ext/Rights.xml`).
## Запуск скрипта
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-info.ps1" -RightsPath <path> -OutFile <output.txt>
```
### Параметры
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-RightsPath` | да | Путь к Rights.xml |
| `-ShowDenied` | нет | Показать запрещённые права (по умолчанию скрыты) |
| `-Limit` | нет | Макс. строк вывода (по умолчанию `150`). `0` = без ограничений |
| `-Offset` | нет | Пропустить N строк — для пагинации (по умолчанию `0`) |
| `-OutFile` | нет | Записать результат в файл (UTF-8 BOM). Без этого — вывод в консоль |
**Важно:** Всегда используй `-OutFile` и читай результат через Read tool. Прямой вывод в консоль через bash ломает кириллицу.
Для большой роли при усечении вывода:
```powershell
... -Offset 150 # пагинация: пропустить первые 150 строк
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills
