nickytonline/marp-kit

nickytonline のプロフィール

記録された最新のソース活動: 2026年9月12日 12:17

SkillsMP カタログ更新: 2026年10月26日 11:37

収集済み skills: 2

GitHub スター: 2
GitHub フォーク: 0

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# marp-kit [Marp](https://marp.app/) slide decks, plus a local dev server and a build you can deploy. This is my go-to workflow for talks. Start the Marp dev server, open the deck in a browser or in your agent's in-app browser, and build the slides in conversation: copy, structure, CSS. The agent can see the deck as it changes. That loop is the point of this kit. `slides.md` is Marp’s empty starter (built-in `default` theme). Write the talk there. | Path | What goes there | | --- | --- | | `slides.md` | The deck. Speaker notes in HTML comments. | | `images/` | Screenshots, GIFs, QR codes. Copied into `dist/` on build. | | `themes/` | Custom Marp CSS. Leave empty to keep the built-in default. | | `public/` | Netlify `/pdf` and `/powerpoint` download rules. | If you rename the deck file, update the `build:*` scripts and the filenames in `public/`. Project skills live in `.agents/skills/`: speaker AI guidance (own the claims, keep your voice) and accessible presentations (can the room follow the slides). Both are genericized from GitHub Universe speaker materials: [AI guidance for speakers](https://static.rainfocus.com/github/universe26/static/staticfile/staticfile/Universe%202026%20AI%20Guidance%20for%20Speakers_1785247787108001NbTV.pdf) and [Guide to accessible presentations](https://static.rainfocus.com/github/universe26/static/staticfile/staticfile/Universe%202026%20-%20Guide%20to%20Accessible%20Presentations_1785334302728001W9Bq.pdf). ## Dev ```bash npm install npm run dev ``` Watch server. Leave it running while you and the agent iterate. ## Build ```bash npm run build # dist/index.html, dist/slides.pdf, dist/slides.pptx npm run build:ci # same, after installing Chrome (for hosts with no browser) ``` Present from the HTML. GIFs freeze on frame one in PDF. Speaker notes stay in Markdown and the HTML presenter view; the PPTX build strips them so a download is not a notes leak. ## QR codes Add QR code targets in `qr-codes.json` and generate images with: ```bash npm run generate:qr ``` Example: ```json { "outputDir": "images", "codes": [ { "name": "slides", "url": "https://example.com" }, { "name": "github", "url": "https://github.com" } ] } ``` If `codes` is empty, the script warns and exits without generating any QR images. ## Deploy I ship talks on [Netlify](https://www.netlify.com/), so this repo includes that setup: - `netlify.toml` — `npm run build:ci`, publish `dist/` - `public/_redirects` and `public/_headers` — `/pdf` and `/powerpoint` as attachment downloads The Marp dev server does not serve those URLs. They exist after a Netlify deploy. If you are on Vercel, Cloudflare, or something else, ignore or delete those three files and map the PDF/PPTX however that host does it. The build still drops `slides.pdf` and `slides.pptx` in `dist/`.

リポジトリの README を読み込んでいます…

このリポジトリの skills

グラフィックデザイナーテクニカルライター

2 件の職業カテゴリ · 100% 分類済み

skill

職業分類

説明

更新

accessible-presentations

グラフィックデザイナー

Apply accessible-presentation checks to this Marp deck. Use when editing slides.md, speaker notes, images, diagrams, QR codes, code on slides, alt text, captions, GIFs, video, theme fonts or colors, contrast, layout density, acronyms, or inclusive language.…

原文の言語: 英語

2026-09-12

speaker-ai-guidance

テクニカルライター

Run speaker AI-guidance checks on talk content. Use when editing slides.md, speaker notes, slide copy, titles, claims, demos, or any spoken or on-slide wording. Apply automatically before finishing content edits: own every claim, keep the speaker's voice,…

原文の言語: 英語

2026-09-12

収集済み skill 2 件中 2 件を表示しています。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/nickytonline/marp-kit.