Agent skill

HTML Presentation Structure Guide

by shanraisshan in shanraisshan/claude-code-best-practice

Documents how a single-file HTML slide deck is built: slide markup, the four-level journey bar, navigation and the renumbering rules after edits.

MITAuto-check passedDocuments & Office

Install HTML Presentation Structure Guide

skills CLI
$ npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install shanraisshan/claude-code-best-practice presentation-structure --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/shanraisshan/claude-code-best-practice.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/presentation/presentation-structure .claude/skills/presentation-structure && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
presentation-structure
GitHub stars
67k
Token cost
~882 tokens
SKILL.md length
340 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Documents how a single-file HTML slide deck is built: slide markup, the four-level journey bar, navigation and the renumbering rules after edits.

  • Works in 4 steps: Renumber ALL data-slide attributes… → Update all goToSlide() calls in the… → The JS totalSlides auto-computes — no… → …
  • Adding or reordering slides in the single-file HTML presentation
  • SKILL.md covers File Location, Slide Format, Journey Bar Level System and Navigation System, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill describes the deck at presentation/index.html, one HTML file with inline CSS and JavaScript. Each slide is a div carrying a sequential data-slide number and, at section transitions, an optional data-level attribute. A journey bar shows progress in four levels, Low, Medium, High and Pro, which fill it to 25%, 50%, 75% and 100%. Slides inherit the level of the last transition slide, and the bar is hidden on the title slide.

A section table maps the parts of the deck to slide ranges and levels, and the level badge on a heading is injected by JavaScript rather than written into the HTML. Navigation uses goToSlide(n) in table-of-contents links, arrow keys, Space and touch swipe, with a counter at the bottom left, and totalSlides is computed from the DOM. After slides are added, removed or reordered, the agent renumbers every data-slide from 1, updates the goToSlide calls in the table-of-contents slide and checks for gaps or duplicates.

When your agent uses it

  • Adding or reordering slides in the single-file HTML presentation
  • Changing the journey bar level at a section divider
  • Fixing table-of-contents links after slides were renumbered

Example prompts

  • “Insert a new slide after the Project Memory divider and fix the numbering.”
  • “Make the Structured Workflows section show the High level on the journey bar.”
  • “Check the presentation for gaps or duplicate data-slide numbers.”

Requirements

  • A presentation/index.html file in the project

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Renumber ALL data-slide attributes sequentially starting from 1
  2. Update all goToSlide() calls in the TOC/Journey Map slide
  3. The JS totalSlides auto-computes — no manual update needed
  4. Verify no gaps or duplicates exist

What it can do on your machine

Read from SKILL.md and the folder at commit 63e587b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HTML Presentation Structure Guide loads about 882 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 340 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~882

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from shanraisshan/claude-code-best-practice at commit 63e587b, republished under its MIT licence (© shanraisshan). 340 words, ~882 tokens.

Download SKILL.mdSave it as .claude/skills/presentation-structure/SKILL.md (or your agent's skills folder).
name
presentation-structure
description
Knowledge about the presentation slide format, weight system, navigation, and section structure

Presentation Structure Skill

Knowledge about how the presentation at presentation/index.html is structured.

File Location

presentation/index.html — a single-file HTML presentation with inline CSS and JS.

Slide Format

Each slide is a div with data-slide (sequential number) and optional data-level (journey level at transition points):

html
<!-- Regular slide — inherits level from previous data-level slide -->
<div class="slide" data-slide="12">
    <h1>Slide Title</h1>
    <!-- content -->
</div>

<!-- Level transition slide — sets new level for this slide and all following -->
<div class="slide section-slide" data-slide="10" data-level="low">
    <h1>Section Name</h1>
    <p class="section-desc">Level: Low — description of this section</p>
</div>

<!-- Title slide (centered) -->
<div class="slide title-slide" data-slide="1">
    <h1>Presentation Title</h1>
    <p class="subtitle">Subtitle text</p>
</div>

Journey Bar Level System

The presentation uses a 4-level system instead of cumulative percentages:

  • Levels are set via data-level attribute on key transition slides (section dividers)
  • All slides after a data-level slide inherit that level until the next transition
  • The journey bar fills to 25% / 50% / 75% / 100% for Low / Medium / High / Pro respectively
  • The bar is hidden on slide 1 (title slide); from slide 2 onward the bar is shown
  • Slides before the first data-level (slides 2–9) show an empty bar (no level yet set)
  • A .level-badge is JS-injected on the <h1> of slides that carry data-level — do NOT hardcode in HTML
Level Transitions by Section
SectionSlide Rangedata-levelBar Height
Part 0: IntroductionSlides 1-4(none)hidden / empty
Part 1: PrerequisitesSlides 5-9(none)empty
Part 2: Better PromptingSlides 10-17low25%
Part 3: Project MemorySlides 18-24medium50%
Part 4: Structured WorkflowsSlides 25-28(inherits medium)50%
Part 5: Domain KnowledgeSlides 29-33high75%
Part 6: Agentic EngineeringSlides 34-46high75%
AppendixSlides 47+(inherits high)75%

Navigation System

  • goToSlide(n) — used in TOC links, must match actual data-slide numbers
  • totalSlides is auto-computed from DOM (document.querySelectorAll('[data-slide]').length)
  • Arrow keys, Space, and touch swipe for navigation
  • Slide counter shows current / total at bottom-left

Renumbering Rules

After adding, removing, or reordering slides:

  1. Renumber ALL data-slide attributes sequentially starting from 1
  2. Update all goToSlide() calls in the TOC/Journey Map slide
  3. The JS totalSlides auto-computes — no manual update needed
  4. Verify no gaps or duplicates exist

Section Divider Format

Section dividers use the section-slide class. Level-transition section dividers carry data-level and show the level name in the description:

html
<div class="slide section-slide" data-slide="10" data-level="low">
    <p class="section-number">Part 2</p>
    <h1>Better Prompting</h1>
    <p class="section-desc">Level: Low — effective prompting for real results.</p>
</div>

The JS will inject a .level-badge (e.g., "→ Low") into the <h1> at runtime when the level transitions — do not add these manually in HTML.

© shanraisshan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/presentation/presentation-structure of shanraisshan/claude-code-best-practice.

Open the folder on GitHubat commit 63e587b

Compare with similar skills

HTML Presentation Structure Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HTML Presentation Structure Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HTML Presentation Structure Guide this skillshanraisshan/claude-code-best-practice67k—~882Automated safety check: PassMIT
Frontend Slideszarazhangrui/frontend-slides30k16 repos~7kAutomated safety check: PassMIT
HTML PPT Studiolewislulu/html-ppt-skill8.6k4 repos~4.7kAutomated safety check: PassMIT
Openkb Deck EditorialVectifyAI/OpenKB4.8k1 repos~2.1kAutomated safety check: PassApache-2.0
Science Content Slide PagesUnclecheng-li/AI-Animation-Skill5741 repos~1.5kAutomated safety check: PassMIT
PPT as CodeRussell-cell/PPT-as-code190—~11kAutomated safety check: PassMIT

Similar skills

  • Frontend Slides

    zarazhangrui/frontend-slides

    Builds animated HTML slide decks that run in the browser with no dependencies, or converts PowerPoint files to the web, starting from visual style previews.

    30k GitHub starsUsed in 16 repos~7k tokens
    Documents & OfficeAuto-check passed
  • HTML PPT Studio

    lewislulu/html-ppt-skill

    Authors static HTML presentations from a library of themes, layouts and animations, with keyboard navigation, for talks, pitch decks and reports.

    8.6k GitHub starsUsed in 4 repos~4.7k tokens
    Documents & OfficeAuto-check passed
  • Openkb Deck Editorial

    VectifyAI/OpenKB

    A skill your agent uses when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content.

    4.8k GitHub starsUsed in 1 repo~2.1k tokens
    Documents & OfficeAuto-check passed
  • Science Content Slide Pages

    Unclecheng-li/AI-Animation-Skill

    Turns popular-science text into an animated slide-style single-page HTML presentation, or restyles it as a flat-UI flowchart, using templates built into the skill.

    574 GitHub starsUsed in 1 repo~1.5k tokens
    Documents & OfficeAuto-check passed
  • PPT as Code

    Russell-cell/PPT-as-code

    Plans and builds HTML-based web presentations through staged quick, basic or advanced workflows, with optional visualization planning, motion, a workbench and PPTX export handoff.

    190 GitHub stars~11k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Superloopy Slides

    beefiker/superloopy

    Creates zero-dependency, animation-rich HTML slide decks that run in the browser, with style presets, PowerPoint conversion and PDF export, proven by a real-browser render.

    111 GitHub starsUsed in 1 repo~8.8k tokens
    Documents & OfficeAuto-check passed

More from shanraisshan/claude-code-best-practice

All 8 skills in this repo
  • Pakistan Time Display

    shanraisshan/claude-code-best-practice

    Display the current time in Pakistan Standard Time (PKT, UTC+5). Use when the user asks for the current time, Pakistan time, or PKT.

    67k GitHub stars~202 tokensUpdated today
    Auto-check passed
  • Presentation Styling Reference

    shanraisshan/claude-code-best-practice

    Reference for the CSS classes, HTML slide patterns and code-block highlighting spans used in a project's presentation/index.html slide deck.

    67k GitHub stars~780 tokensUpdated today
    Auto-check passed
  • Vibe to Agentic Engineering Framework

    shanraisshan/claude-code-best-practice

    Explains the conceptual model behind a presentation on moving from unstructured vibe coding to fully configured agentic engineering, including its 4-level scoring system and slide conventions.

    67k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Dubai Weather Fetcher

    shanraisshan/claude-code-best-practice

    Reads the current temperature in Dubai from the Open-Meteo API with a single web fetch and returns it in Celsius or Fahrenheit.

    67k GitHub stars~397 tokensUpdated today
    Auto-check passed
  • Dubai Time Fetcher

    shanraisshan/claude-code-best-practice

    Instructions for fetching current Dubai time via bash command

    67k GitHub stars~155 tokensUpdated today
    Auto-check passed
  • Dubai Time SVG Creator

    shanraisshan/claude-code-best-practice

    Creates an SVG time card showing the current time for Dubai. Writes the SVG to agent-teams/output/dubai-time.svg and updates agent-teams/output/output.md.

    67k GitHub stars~299 tokensUpdated today
    Auto-check passed

Questions about HTML Presentation Structure Guide

What does HTML Presentation Structure Guide do?

Documents how a single-file HTML slide deck is built: slide markup, the four-level journey bar, navigation and the renumbering rules after edits. html, one HTML file with inline CSS and JavaScript. Each slide is a div carrying a sequential data-slide number and, at section transitions, an optional data-level attribute.

When should I use HTML Presentation Structure Guide?

HTML Presentation Structure Guide fits situations like: adding or reordering slides in the single-file HTML presentation; changing the journey bar level at a section divider; fixing table-of-contents links after slides were renumbered.

How do I install HTML Presentation Structure Guide in Claude Code?

Run `npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -a claude-code`. Or copy the skill folder (.claude/skills/presentation/presentation-structure in shanraisshan/claude-code-best-practice) into .claude/skills/presentation-structure in your project. Claude Code loads it when a task matches its description.

How do I install HTML Presentation Structure Guide in Codex?

Run `npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -a codex`. Or copy the skill folder (.claude/skills/presentation/presentation-structure in shanraisshan/claude-code-best-practice) into .agents/skills/presentation-structure in your project. Codex loads it when a task matches its description.

Can I use HTML Presentation Structure Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/presentation-structure, .gemini/skills/presentation-structure, .github/skills/presentation-structure and .opencode/skills/presentation-structure in your project.

What does HTML Presentation Structure Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: HTML Presentation Structure Guide is instructions for the agent only. Our summary lists: A presentation/index.html file in the project.

Does HTML Presentation Structure Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is HTML Presentation Structure Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does HTML Presentation Structure Guide use?

HTML Presentation Structure Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does HTML Presentation Structure Guide use?

About 882 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to HTML Presentation Structure Guide?

Skills that share tags, products or a category with HTML Presentation Structure Guide: Frontend Slides (zarazhangrui/frontend-slides, 30k stars), HTML PPT Studio (lewislulu/html-ppt-skill, 8.6k stars), Openkb Deck Editorial (VectifyAI/OpenKB, 4.8k stars) and Science Content Slide Pages (Unclecheng-li/AI-Animation-Skill, 574 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HTML Presentation Structure Guide?

shanraisshan (a GitHub user) maintains it in shanraisshan/claude-code-best-practice, which has 67,323 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 10, 2026.

Source: shanraisshan/claude-code-best-practice on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.