# zhoulinhua0-star/scroll-reveal-motion architecture

> Architecture diagram of the GitHub repository zhoulinhua0-star/scroll-reveal-motion, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zhoulinhua0-star/scroll-reveal-motion
- Repository: https://github.com/zhoulinhua0-star/scroll-reveal-motion

## Overview

Scroll Reveal Motion is a pair of coding-agent skills, not a drop-in animation library. A user invokes a skill through Claude Code or Codex; the coding agent applies its guidance and resources to the user's frontend. The scroll skill supports viewport-triggered reveals through React or Vanilla implementations and shared CSS; the hero skill provides entrance-animation guidance, CSS, and an optional helper. The README documents these capabilities, but the sampled source does not show how agents execute the skill instructions.

Main entry points: [`skills/hero-text-reveal/SKILL.md`](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/SKILL.md) (Hero Skill Guidance), [`skills/scroll-reveal-motion/SKILL.md`](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/SKILL.md) (Scroll Skill Guidance), [`.claude-plugin/plugin.json`](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/.claude-plugin/plugin.json) (Claude Plugin), [`skills/hero-text-reveal/references/diagnosis-and-timing.md`](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/references/diagnosis-and-timing.md) (Timing Guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hero["Hero Text Reveal"]
  node_hero_skill["Hero Skill Guidance<br/>[SKILL.md]"]
  node_hero_timing["Timing Guidance"]
  node_hero_phi["Phi Entrance Guidance<br/>[phi-entrance.md]"]
  node_hero_css["Hero Reveal CSS"]
  node_hero_helper["Completion Helper"]
end

subgraph group_scroll["Scroll Reveal Motion"]
  node_scroll_skill["Scroll Skill Guidance<br/>[SKILL.md]"]
  node_scroll_react["React Controller<br/>[scroll-reveal.tsx]"]
  node_scroll_vanilla["Vanilla Controller<br/>[scroll-reveal.js]"]
  node_scroll_css["Shared Reveal CSS<br/>[scroll-reveal.css]"]
  node_scroll_validation["Reveal Validation Guidance<br/>[validation.md]"]
end

subgraph group_distribution["Skill Distribution"]
  node_plugin["Claude Plugin<br/>[plugin.json]"]
  node_marketplace["Marketplace Listing<br/>[marketplace.json]"]
end

node_user(("User"))
node_claude["Claude Code"]
node_codex["Codex"]
node_frontend["User Frontend"]

node_user -->|"installs or invokes"| node_claude
node_user -->|"installs or invokes"| node_codex
node_claude -->|"invokes"| node_hero_skill
node_claude -->|"invokes"| node_scroll_skill
node_codex -->|"invokes"| node_hero_skill
node_codex -->|"invokes"| node_scroll_skill
node_hero_skill -->|"uses guidance"| node_hero_timing
node_hero_skill -->|"uses guidance"| node_hero_phi
node_hero_skill -->|"provides styles"| node_hero_css
node_hero_skill -->|"provides helper"| node_hero_helper
node_scroll_skill -->|"provides component"| node_scroll_react
node_scroll_skill -->|"provides controller"| node_scroll_vanilla
node_scroll_skill -->|"provides styles"| node_scroll_css
node_scroll_skill -->|"provides guidance"| node_scroll_validation
node_hero_skill -->|"guides adaptation"| node_frontend
node_scroll_skill -->|"guides adaptation"| node_frontend
node_claude -->|"installs plugin"| node_plugin
node_plugin -->|"listed in"| node_marketplace

click node_hero_skill "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/SKILL.md"
click node_hero_timing "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/references/diagnosis-and-timing.md"
click node_hero_phi "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/references/phi-entrance.md"
click node_hero_css "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/assets/hero-text-reveal.css"
click node_hero_helper "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/assets/hero-text-reveal.js"
click node_scroll_skill "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/SKILL.md"
click node_scroll_react "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/react/scroll-reveal.tsx"
click node_scroll_vanilla "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/vanilla/scroll-reveal.js"
click node_scroll_css "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/scroll-reveal.css"
click node_scroll_validation "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/references/validation.md"
click node_plugin "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/.claude-plugin/plugin.json"
click node_marketplace "https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/.claude-plugin/marketplace.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_hero_skill,node_hero_timing,node_hero_phi,node_hero_css,node_hero_helper,node_user,node_frontend toneBlue
class node_scroll_skill,node_scroll_react,node_scroll_vanilla,node_scroll_css,node_scroll_validation toneAmber
class node_plugin,node_marketplace toneMint
class node_claude,node_codex toneIndigo
```

## Components

### Hero Text Reveal

- [Hero Skill Guidance](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/SKILL.md): `skills/hero-text-reveal/SKILL.md`
- [Timing Guidance](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/references/diagnosis-and-timing.md): `skills/hero-text-reveal/references/diagnosis-and-timing.md`
- [Phi Entrance Guidance](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/references/phi-entrance.md): `skills/hero-text-reveal/references/phi-entrance.md`
- [Hero Reveal CSS](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/assets/hero-text-reveal.css): `skills/hero-text-reveal/assets/hero-text-reveal.css`
- [Completion Helper](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/hero-text-reveal/assets/hero-text-reveal.js): `skills/hero-text-reveal/assets/hero-text-reveal.js`

### Scroll Reveal Motion

- [Scroll Skill Guidance](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/SKILL.md): `skills/scroll-reveal-motion/SKILL.md`
- [React Controller](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/react/scroll-reveal.tsx): `skills/scroll-reveal-motion/assets/react/scroll-reveal.tsx`
- [Vanilla Controller](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/vanilla/scroll-reveal.js): `skills/scroll-reveal-motion/assets/vanilla/scroll-reveal.js`
- [Shared Reveal CSS](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/assets/scroll-reveal.css): `skills/scroll-reveal-motion/assets/scroll-reveal.css`
- [Reveal Validation Guidance](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/skills/scroll-reveal-motion/references/validation.md): `skills/scroll-reveal-motion/references/validation.md`

### Skill Distribution

- [Claude Plugin](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Marketplace Listing](https://github.com/zhoulinhua0-star/scroll-reveal-motion/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`

### Other components

- **User**
- **Claude Code**
- **Codex**
- **User Frontend**

## Connections

- User → Claude Code: installs or invokes (evidence: `README.md`)
- User → Codex: installs or invokes (evidence: `README.md`)
- Claude Code → Hero Skill Guidance: invokes (evidence: `README.md`)
- Claude Code → Scroll Skill Guidance: invokes (evidence: `README.md`)
- Codex → Hero Skill Guidance: invokes (evidence: `README.md`)
- Codex → Scroll Skill Guidance: invokes (evidence: `README.md`)
- Hero Skill Guidance → Timing Guidance: uses guidance (evidence: `README.md`)
- Hero Skill Guidance → Phi Entrance Guidance: uses guidance (evidence: `README.md`)
- Hero Skill Guidance → Hero Reveal CSS: provides styles (evidence: `README.md`)
- Hero Skill Guidance → Completion Helper: provides helper (evidence: `README.md`)
- Scroll Skill Guidance → React Controller: provides component (evidence: `README.md`)
- Scroll Skill Guidance → Vanilla Controller: provides controller (evidence: `README.md`)
- Scroll Skill Guidance → Shared Reveal CSS: provides styles (evidence: `README.md`)
- Scroll Skill Guidance → Reveal Validation Guidance: provides guidance (evidence: `README.md`)
- Hero Skill Guidance → User Frontend: guides adaptation (evidence: `README.md`)
- Scroll Skill Guidance → User Frontend: guides adaptation (evidence: `README.md`)
- Claude Code → Claude Plugin: installs plugin (evidence: `README.md`)
- Claude Plugin → Marketplace Listing: listed in (evidence: `README.md`)
