Agent Skillsshanraisshan/claude-code-best-practice › presentation-structure

presentation-structure

GitHub

定义presentation/index.html演示文稿的结构规范,包括幻灯片格式、旅程栏等级系统、导航逻辑及重新编号规则,确保内容层级与交互一致。

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

Trigger Scenarios

修改演示文稿HTML结构 调整幻灯片顺序或数量 更新导航链接或等级属性

Install

npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -g -y
More Options

Non-standard path

npx skills add https://github.com/shanraisshan/claude-code-best-practice/tree/main/.claude/skills/presentation/presentation-structure -g -y

Use without installing

npx skills use shanraisshan/claude-code-best-practice@presentation-structure

指定 Agent (Claude Code)

npx skills add shanraisshan/claude-code-best-practice --skill presentation-structure -a claude-code -g -y

安装 repo 全部 skill

npx skills add shanraisshan/claude-code-best-practice --all -g -y

预览 repo 内 skill

npx skills add shanraisshan/claude-code-best-practice --list

SKILL.md

Frontmatter
{
    "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):

<!-- 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

Section Slide Range data-level Bar Height
Part 0: Introduction Slides 1-4 (none) hidden / empty
Part 1: Prerequisites Slides 5-9 (none) empty
Part 2: Better Prompting Slides 10-17 low 25%
Part 3: Project Memory Slides 18-24 medium 50%
Part 4: Structured Workflows Slides 25-28 (inherits medium) 50%
Part 5: Domain Knowledge Slides 29-33 high 75%
Part 6: Agentic Engineering Slides 34-46 high 75%
Appendix Slides 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:

<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.

Version History

  • 8335ca8 Current 2026-07-25 04:18

Same Skill Collection

.claude/skills/agent-browser/SKILL.md
.claude/skills/presentation/presentation-styling/SKILL.md
.claude/skills/presentation/vibe-to-agentic-framework/SKILL.md
.claude/skills/time-skill/SKILL.md
.claude/skills/weather-fetcher/SKILL.md
.claude/skills/weather-svg-creator/SKILL.md
agent-teams/.claude/skills/time-fetcher/SKILL.md
agent-teams/.claude/skills/time-svg-creator/SKILL.md

Metadata

Files
0
Version
7b03320
Hash
5a39c508
Indexed
2026-07-25 04:18

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-21 01:46
浙ICP备14020137号-1 $방문자$