# Send Web Deploy GitHub Pages to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "web-deploy-github",
    "name": "Web Deploy GitHub Pages",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ThomekSolutions/web-deploy-github",
    "canonicalUrl": "https://clawhub.ai/ThomekSolutions/web-deploy-github",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/web-deploy-github",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=web-deploy-github",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "assets/templates/base-html/index.html",
      "assets/templates/base-html/script.js",
      "assets/templates/base-html/styles.css",
      "assets/templates/landing/index.html",
      "assets/templates/landing/script.js",
      "assets/templates/landing/styles.css"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "web-deploy-github",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T20:38:11.095Z",
      "expiresAt": "2026-05-17T20:38:11.095Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=web-deploy-github",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=web-deploy-github",
        "contentDisposition": "attachment; filename=\"web-deploy-github-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "web-deploy-github"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/web-deploy-github"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/web-deploy-github",
    "downloadUrl": "https://openagent3.xyz/downloads/web-deploy-github",
    "agentUrl": "https://openagent3.xyz/skills/web-deploy-github/agent",
    "manifestUrl": "https://openagent3.xyz/skills/web-deploy-github/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/web-deploy-github/agent.md"
  }
}
```
## Documentation

### Overview

This skill enables autonomous creation and deployment of static websites to GitHub Pages. It follows a complete workflow from project structure initialization through automatic deployment via GitHub Actions, optimized for single-page applications, portfolios, and landing pages.

### 1. Project Initialization

Create the project structure:

bash scripts/init_project.sh <project-name>

This creates:

project-name/
├── index.html
├── styles.css
├── script.js
├── README.md
└── .github/
    └── workflows/
        └── deploy.yml

### 2. Development

Build the website following these principles:

Single-page first: Optimize for one-page layouts unless multiple pages explicitly required
Autonomous generation: Generate complete, production-ready code without placeholders
Modern design: Use modern CSS (flexbox, grid), responsive design, clean aesthetics
No dependencies: Pure HTML/CSS/JS when possible, CDN links if frameworks needed

Use templates from assets/templates/ as starting points:

base-html/ - Minimal HTML5 boilerplate
portfolio/ - Portfolio/CV template with sections
landing/ - Landing page with hero and CTA

### 3. GitHub Repository Setup

bash scripts/deploy_github_pages.sh <project-name> <github-username>

This script:

Initializes git repository
Creates GitHub repository via GitHub CLI
Configures GitHub Pages settings
Pushes initial commit
Triggers first deployment

### 4. Deployment

GitHub Actions automatically deploys on push to main branch. The workflow:

Checks out code
Deploys to gh-pages branch
Makes site live at https://<username>.github.io/<project-name>/

### HTML Structure

Semantic HTML5 elements
Meta tags for SEO and social sharing
Responsive viewport configuration
Favicon and icons

### CSS Design

Mobile-first responsive design
CSS variables for theming
Flexbox/Grid for layouts
Smooth transitions and animations
Dark mode support when appropriate

### JavaScript

Vanilla JS preferred
Progressive enhancement
Event delegation
No console errors

### Performance

Optimized images
Minified assets for production
Lazy loading where appropriate
Fast initial load time

### Example 1: Portfolio CV Site

User request: "Crée-moi un site portfolio CV"

Action:

Run init_project.sh portfolio-cv
Use assets/templates/portfolio/ as base
Generate complete HTML with sections: Hero, About, Skills, Projects, Contact
Deploy with deploy_github_pages.sh portfolio-cv username

### Example 2: Landing Page

User request: "Fais-moi une landing page pour mon app"

Action:

Run init_project.sh app-landing
Use assets/templates/landing/ as base
Generate with Hero, Features, Pricing, CTA
Deploy with deploy_github_pages.sh app-landing username

### GitHub Pages Not Deploying

Check repository Settings → Pages → Source is set to gh-pages branch
Verify GitHub Actions workflow ran successfully
Check DNS propagation (can take 5-10 minutes)

### Permission Errors

Ensure gh CLI is authenticated: gh auth status
Check repository permissions on GitHub

### Build Failures

Review Actions logs in repository
Verify .github/workflows/deploy.yml syntax
Check file paths and references

### scripts/

init_project.sh - Initialize project structure
deploy_github_pages.sh - Deploy to GitHub Pages

### references/

workflow.md - Detailed workflow documentation
design-patterns.md - Design best practices

### assets/

templates/base-html/ - Minimal HTML5 boilerplate
templates/portfolio/ - Portfolio/CV template
templates/landing/ - Landing page template
.github/workflows/deploy.yml - GitHub Actions workflow template
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ThomekSolutions
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T20:38:11.095Z
- Expires at: 2026-05-17T20:38:11.095Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/web-deploy-github)
- [Send to Agent page](https://openagent3.xyz/skills/web-deploy-github/agent)
- [JSON manifest](https://openagent3.xyz/skills/web-deploy-github/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/web-deploy-github/agent.md)
- [Download page](https://openagent3.xyz/downloads/web-deploy-github)