redhat-et / redhat-et/docsclaw

Presentation-creating skills with Marp and Mermaid tooling

Open
#10 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
2
Forks
1
Avg merge
6h 9m
Merged PRs (30d)
1

Description

Summary

Bundle presentation-creating skills and the necessary rendering tools so DocsClaw agents can generate slide decks.

Motivation

Creating presentations is a common business task that agents can assist with. The skills define how to create good slides; the tools (Marp, Mermaid) handle rendering to PDF/PNG/HTML.

Skill sources

  • lecture-slides / lecture-script — Pavel Anni's Marp-based slide and narration generation skills (see ~/personal/mephi/lecturer/.claude/skills/)
  • red-hat-quick-deck — Todd Ward's Red Hat-branded HTML presentation skill (github.com/toddward/red-hat-quick-deck)

These need to be adapted for DocsClaw's skill format and generalized beyond their current specific use cases.

Required tools (for the presentations image flavor)

  • marp-cli — Markdown to slides (PDF, PNG, HTML, PPTX)
  • mermaid-cli (mmdc) — diagram rendering
  • chromium-headless — required by both Marp and Mermaid for rendering
  • Optionally: custom Marp themes (graph_paper, Red Hat branded)

Acceptance criteria

  • Presentation skill(s) adapted for DocsClaw's SKILL.md format
  • Skills included in the presentations Docker image flavor (#7)
  • Agent can generate Marp Markdown and render to PDF/HTML
  • Agent can generate Mermaid diagrams and embed rendered output
  • Example agent-config.yaml for a presentation-creating agent

Related

  • #7 — Specialized Dockerfiles (presentations flavor)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the DocsClaw skill format and the source skills under ~/personal/mephi/lecturer/.claude/skills/, then inspect the presentations Docker image work in issue #7. Adapt the selected skills into SKILL.md files and add the example agent-config.yaml. Done means the presentations flavor includes the skills and tools, and the acceptance criteria can be demonstrated for Marp output and Mermaid diagrams.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, markdown, yaml
Domain
devops, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.