github-pages-architecture

Plan GitHub Pages static UI architecture with a three-tier dependency chain.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/Junghyun99/MagicSplit --skill github-pages-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pages-architecture
Source: https://github.com/Junghyun99/MagicSplit/tree/main/.claude/skills/github-pages-architecture
Command: npx skills add https://github.com/Junghyun99/MagicSplit --skill github-pages-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Pages static UIs often suffer from ad-hoc architectures that mix presentation, application logic, and infrastructure. This skill provides a clear, repeatable 3-tier design (Presentation/Application/Infrastructure) and guidance on docs/ directory structure, module separation, lazy loading, and data-flow definitions to improve maintainability and scalability.

Core Features & Use Cases

  • Define a consistent docs/ directory structure for GitHub Pages projects.
  • Add new tabs/pages, split JavaScript modules, and manage lazy loading.
  • Establish data flow and orchestration patterns between UI and data sources while keeping components decoupled.
  • Use cases include refactoring an existing static UI, designing new modules with clear responsibilities, and planning scalable tab-based interfaces.

Quick Start

Use this skill when designing docs/ directory structure, adding tabs, splitting modules, implementing lazy loading, managing chart instances, or defining data flow in a GitHub Pages static web UI.

Frequently Asked Questions about github-pages-architecture

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

FAQPage Schema
How do I structure a scalable docs directory for a GitHub Pages static UI?

A scalable GitHub Pages architecture uses a 3-tier design separating presentation, application, and infrastructure layers. It prescribes a modular docs/ directory structure with a one-way dependency chain to keep static UI components decoupled and maintainable.

What is the best way to add tabs and split JavaScript modules in GitHub Pages?

The best way to add tabs and split modules in GitHub Pages is applying a 3-tier architecture with independent dependency chains. This separates presentation from application logic, using tab routing practices and clear data flow orchestration to keep components decoupled.

How does lazy loading work with GitHub Pages static interfaces?

Lazy loading for GitHub Pages interfaces is implemented by deferring module loading based on tab routing. The architecture prescribes lazy-loading practices within a modular directory structure to orchestrate data flow efficiently while keeping presentation and infrastructure decoupled.

When do I need to refactor an existing GitHub Pages static UI architecture?

You need to refactor a GitHub Pages UI when ad-hoc architectures mix presentation, application logic, and infrastructure. Applying a 3-tier modular design with lazy loading and one-way dependencies restores maintainability and scalability when adding tabs or splitting modules.

Can I use this modular architecture approach for any static site or just GitHub Pages?

This modular architecture is specifically applied for GitHub Pages static web UIs. It defines data flow and orchestration patterns tailored to the platform's constraints, ensuring presentation, application, and infrastructure layers remain separated within the docs/ directory structure.

Why does my GitHub Pages UI feel hard to maintain when adding new pages?

Your GitHub Pages UI is hard to maintain because ad-hoc architectures mix presentation, application, and infrastructure layers. Implementing a 3-tier design with a one-way dependency chain and modular directory structure decouples components, resolving the maintainability issue.