guia-readme-para-slides

Converts README guides into Marp slide decks following the IFSul theme and pedagogical structure.

5|Updated Jun 7, 2022
One-click install
npx skills add https://github.com/werlang/pw1 --skill guia-readme-para-slides-werlang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: guia-readme-para-slides
Source: https://github.com/werlang/pw1/tree/main/.agents/skills/guia-readme-para-slides
Command: npx skills add https://github.com/werlang/pw1 --skill guia-readme-para-slides-werlang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a dense README guide into classroom slides often produces overcrowded, copy-pasted decks that do not support oral explanation. This Skill transforms README content into concise Marp presentations aligned with the IFSul theme, the repository's pedagogical progression, and current exercise lists. ## Core Features & Use Cases - README-to-slides conversion: Reads the full README guide, inspects examples and exercises, and produces a Marp Markdown deck with opening, concept, mechanism, comparison, exercise, and summary slides. - Layout and density rules: Enforces the utility classes from marp/themes/positioning.css, bans legacy classes like grid-2 or vcenter, limits bullets and code length, and splits long exercise lists across slides. - Placeholder and asset handling: Inserts <img class="placeholder"> blocks with Prompt de IA: alt text when images do not exist yet, and swaps in real assets from marp/assets/ during visual refinement. - Use Case: A teacher updates the DOM manipulation section of the Web Programming I course and needs new slides; the Skill reads the section README, verifies current exercise paths, and generates a validated Marp deck ready for marp/build.sh. ## Quick Start Use the guia-readme-para-slides skill to turn the README of this course section into a Marp slide deck in marp/content/ following the IFSul theme.

Frequently Asked Questions about guia-readme-para-slides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a README into Marp slides for a class?▼

Read the full README guide, inspect the section's examples and exercises, then build a Marp Markdown deck with an opening slide, concept slides, examples, and current exercises. Follow the IFSul theme frontmatter and validate with marp/build.sh.

What Marp theme and frontmatter does this slide deck use?▼

The deck uses the ifsul theme with marp: true, an empty header, and the footer 'Instituto Federal Sul-rio-grandense | Campus Charqueadas'. This frontmatter must be kept unchanged in every generated presentation.

Which CSS layout classes are allowed in the Marp slides?▼

Only the utility classes from marp/themes/positioning.css are allowed, such as grid, grid-cols-*, flex, items-*, mx-auto, and media. Legacy classes like grid-2, span-2, vcenter, vfill, and align-center must not be used.

How are missing images handled in generated slides?▼

When an image asset does not exist yet, the slide reserves space with an img element using class placeholder and an alt attribute starting with 'Prompt de IA:' describing the intended illustration. A real src is only added later when the asset exists in marp/assets/.

How many bullets and exercises should each slide contain?▼

Each slide should carry one main idea with 3 to 5 bullets, never more than 6 short ones, and code limited to about 6 to 10 lines. A list of five exercises should be split across at least two slides, each described by its distinctive reasoning.