marp-slide-quality — скилл для Claude Code
Скилл marp-slide-quality проверяет Marp Markdown-презентации через метрики SlideGauge, оценивает доступность, цвета и вёрстку, затем помогает исправить недочёты.
MIT 202 установок ★ 35 обновлён 2026-10-21
npx skills add podo/design-agent-skills --skill marp-slide-quality -a claude-codeЧто делает marp-slide-quality
Скилл сканирует файлы Markdown с заголовком marp: true и строит отчёт качества. Он анализирует доступность разметки вроде alt-текстов и контраста, проверяет блоки кода, цветовую гамму, плотность текста и макет слайдов. В отчёте показывается общий балл и доля пройденных проверок с советами по правкам: убрать лишние пункты списков или сократить растянутый текст. После правок проверку можно запустить заново.
Инструмент оценивает исходный Markdown, а не финальный рендер, поэтому для презентаций на Reveal.js или Slidev он не подходит. Для запуска обязательны утилита uv с поддержкой uvx и доступ в сеть: инструмент SlideGauge подтягивается на лету напрямую из GitHub-репозитория, а для JSON-фильтрации в примерах используется jq.
Какие задачи решает
- оценить доступность слайдов Marp по контрасту и alt-текстам
- выявить перегруженные текстом слайды и длинные списки
- проверить цветовую гамму и макет Markdown-презентации
- пересчитать оценку качества слайдов после внесения правок
Примеры запросов агенту
- Проверь качество презентации
slides.mdчерез marp slide quality - Запусти SlideGauge для оценки разметки текущих слайдов
- Используй marp-slide-quality, чтобы найти проблемы с контрастом и плотностью текста
Как установить marp-slide-quality
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slide-quality -a claude-code2Вручную: положить файлы
~/.claude/skills/marp-slide-quality/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/marp-slide-quality/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slide-quality -a codex2Вручную: положить файлы
.agents/skills/marp-slide-quality/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slide-quality -a cursor2Вручную: положить файлы
.cursor/skills/marp-slide-quality/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/marp-slide-quality2Вручную: положить файлы
.github/skills/marp-slide-quality/SKILL.md1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slide-quality -a gemini-cli2Командой платформы
gemini skills install https://github.com/podo/design-agent-skills --path skills/marp-slide-qualityВручную: положить файлы
.devin/skills/marp-slide-quality/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill marp-slide-quality -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о marp-slide-quality
Как установить marp-slide-quality в Claude Code?
Выполните команду npx skills add podo/design-agent-skills --skill marp-slide-quality -a claude-code в терминале.
Что делает marp-slide-quality?
Анализирует исходный Markdown презентации Marp с помощью SlideGauge, выставляет баллы за доступность, код, цвета и макет, а затем выдаёт рекомендации по исправлению.
Какие системные утилиты нужны для работы скилла?
Требуется пакетный менеджер uv (команда uvx) для запуска SlideGauge из репозитория и утилита jq для обработки JSON.
Исходный текст
SKILL.md · MIT
--- name: marp-slide-quality description: | Analyzes and improves Marp Markdown presentations using SlideGauge quality scoring — checks accessibility (alt text, contrast), code, color, content density and layout on the Markdown source. Use as a companion to marp-slides, run after slide creation. triggers: - "marp slide quality" - "SlideGauge" - "marp-slide-quality" - "nibzard marp" das: type: skill category: presentations upstream: "https://github.com/nibzard/marp-slide-quality" upstream_path: "SKILL.md" version: latest install: true --- # marp-slide-quality > Catalogue stub — full skill: [nibzard/marp-slide-quality](https://github.com/nibzard/marp-slide-quality) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** - Global: `f=~/.agents/skills/marp-slide-quality/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/marp-slide-quality/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `marp-slide-quality`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/marp-slide-quality ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add nibzard/marp-slide-quality --skill marp-slide-quality -g -y ``` **Project:** ```bash npx skills add nibzard/marp-slide-quality --skill marp-slide-quality -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** uv (provides uvx): the skill runs `uvx --from git+https://github.com/nibzard/slidegauge slidegauge ...`, which fetches and executes SlideGauge from that GitHub repo at use time (not a PyPI package); jq for the JSON-filter examples in the skill - **License:** Apache-2.0 <!-- das:install:end --> ## Invoke after install - Skill name: `marp-slide-quality` - Trigger phrases: "marp slide quality", "SlideGauge", "marp-slide-quality", "nibzard marp" ## What it does Runs SlideGauge quality analysis on Marp Markdown presentations (files with `marp: true` frontmatter) and helps fix what it finds: overall score and pass rate, plus per-category issues for accessibility, code, color, content and layout. Produces a scored report with specific fix recommendations (too many bullets, overlong content and similar) and re-runs the analysis after changes. Best used as a post-creation review pass after `marp-slides` generates the initial deck. SlideGauge is not bundled: the skill runs it through `uvx` from its own GitHub repository each time, so it needs `uv` and network access, and it executes code fetched from that repository. ## When NOT to use - Reveal.js or Slidev presentations — SlideGauge is Marp-specific - Creating slides from scratch — use `marp-slides` first, then run this for quality review - When you need Marp rendered output — this analyzes the Markdown source, not the render
© podo · MIT · podo/design-agent-skills