{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/web-deploy-github",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=web-deploy-github",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "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"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/web-deploy-github",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "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."
      },
      {
        "title": "1. Project Initialization",
        "body": "Create the project structure:\n\nbash scripts/init_project.sh <project-name>\n\nThis creates:\n\nproject-name/\n├── index.html\n├── styles.css\n├── script.js\n├── README.md\n└── .github/\n    └── workflows/\n        └── deploy.yml"
      },
      {
        "title": "2. Development",
        "body": "Build the website following these principles:\n\nSingle-page first: Optimize for one-page layouts unless multiple pages explicitly required\nAutonomous generation: Generate complete, production-ready code without placeholders\nModern design: Use modern CSS (flexbox, grid), responsive design, clean aesthetics\nNo dependencies: Pure HTML/CSS/JS when possible, CDN links if frameworks needed\n\nUse templates from assets/templates/ as starting points:\n\nbase-html/ - Minimal HTML5 boilerplate\nportfolio/ - Portfolio/CV template with sections\nlanding/ - Landing page with hero and CTA"
      },
      {
        "title": "3. GitHub Repository Setup",
        "body": "bash scripts/deploy_github_pages.sh <project-name> <github-username>\n\nThis script:\n\nInitializes git repository\nCreates GitHub repository via GitHub CLI\nConfigures GitHub Pages settings\nPushes initial commit\nTriggers first deployment"
      },
      {
        "title": "4. Deployment",
        "body": "GitHub Actions automatically deploys on push to main branch. The workflow:\n\nChecks out code\nDeploys to gh-pages branch\nMakes site live at https://<username>.github.io/<project-name>/"
      },
      {
        "title": "HTML Structure",
        "body": "Semantic HTML5 elements\nMeta tags for SEO and social sharing\nResponsive viewport configuration\nFavicon and icons"
      },
      {
        "title": "CSS Design",
        "body": "Mobile-first responsive design\nCSS variables for theming\nFlexbox/Grid for layouts\nSmooth transitions and animations\nDark mode support when appropriate"
      },
      {
        "title": "JavaScript",
        "body": "Vanilla JS preferred\nProgressive enhancement\nEvent delegation\nNo console errors"
      },
      {
        "title": "Performance",
        "body": "Optimized images\nMinified assets for production\nLazy loading where appropriate\nFast initial load time"
      },
      {
        "title": "Example 1: Portfolio CV Site",
        "body": "User request: \"Crée-moi un site portfolio CV\"\n\nAction:\n\nRun init_project.sh portfolio-cv\nUse assets/templates/portfolio/ as base\nGenerate complete HTML with sections: Hero, About, Skills, Projects, Contact\nDeploy with deploy_github_pages.sh portfolio-cv username"
      },
      {
        "title": "Example 2: Landing Page",
        "body": "User request: \"Fais-moi une landing page pour mon app\"\n\nAction:\n\nRun init_project.sh app-landing\nUse assets/templates/landing/ as base\nGenerate with Hero, Features, Pricing, CTA\nDeploy with deploy_github_pages.sh app-landing username"
      },
      {
        "title": "GitHub Pages Not Deploying",
        "body": "Check repository Settings → Pages → Source is set to gh-pages branch\nVerify GitHub Actions workflow ran successfully\nCheck DNS propagation (can take 5-10 minutes)"
      },
      {
        "title": "Permission Errors",
        "body": "Ensure gh CLI is authenticated: gh auth status\nCheck repository permissions on GitHub"
      },
      {
        "title": "Build Failures",
        "body": "Review Actions logs in repository\nVerify .github/workflows/deploy.yml syntax\nCheck file paths and references"
      },
      {
        "title": "scripts/",
        "body": "init_project.sh - Initialize project structure\ndeploy_github_pages.sh - Deploy to GitHub Pages"
      },
      {
        "title": "references/",
        "body": "workflow.md - Detailed workflow documentation\ndesign-patterns.md - Design best practices"
      },
      {
        "title": "assets/",
        "body": "templates/base-html/ - Minimal HTML5 boilerplate\ntemplates/portfolio/ - Portfolio/CV template\ntemplates/landing/ - Landing page template\n.github/workflows/deploy.yml - GitHub Actions workflow template"
      }
    ],
    "body": "Web Deploy GitHub Pages\nOverview\n\nThis 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.\n\nCore Workflow\n1. Project Initialization\n\nCreate the project structure:\n\nbash scripts/init_project.sh <project-name>\n\n\nThis creates:\n\nproject-name/\n├── index.html\n├── styles.css\n├── script.js\n├── README.md\n└── .github/\n    └── workflows/\n        └── deploy.yml\n\n2. Development\n\nBuild the website following these principles:\n\nSingle-page first: Optimize for one-page layouts unless multiple pages explicitly required\nAutonomous generation: Generate complete, production-ready code without placeholders\nModern design: Use modern CSS (flexbox, grid), responsive design, clean aesthetics\nNo dependencies: Pure HTML/CSS/JS when possible, CDN links if frameworks needed\n\nUse templates from assets/templates/ as starting points:\n\nbase-html/ - Minimal HTML5 boilerplate\nportfolio/ - Portfolio/CV template with sections\nlanding/ - Landing page with hero and CTA\n3. GitHub Repository Setup\nbash scripts/deploy_github_pages.sh <project-name> <github-username>\n\n\nThis script:\n\nInitializes git repository\nCreates GitHub repository via GitHub CLI\nConfigures GitHub Pages settings\nPushes initial commit\nTriggers first deployment\n4. Deployment\n\nGitHub Actions automatically deploys on push to main branch. The workflow:\n\nChecks out code\nDeploys to gh-pages branch\nMakes site live at https://<username>.github.io/<project-name>/\nArchitecture Guidelines\nHTML Structure\nSemantic HTML5 elements\nMeta tags for SEO and social sharing\nResponsive viewport configuration\nFavicon and icons\nCSS Design\nMobile-first responsive design\nCSS variables for theming\nFlexbox/Grid for layouts\nSmooth transitions and animations\nDark mode support when appropriate\nJavaScript\nVanilla JS preferred\nProgressive enhancement\nEvent delegation\nNo console errors\nPerformance\nOptimized images\nMinified assets for production\nLazy loading where appropriate\nFast initial load time\nQuick Examples\nExample 1: Portfolio CV Site\n\nUser request: \"Crée-moi un site portfolio CV\"\n\nAction:\n\nRun init_project.sh portfolio-cv\nUse assets/templates/portfolio/ as base\nGenerate complete HTML with sections: Hero, About, Skills, Projects, Contact\nDeploy with deploy_github_pages.sh portfolio-cv username\nExample 2: Landing Page\n\nUser request: \"Fais-moi une landing page pour mon app\"\n\nAction:\n\nRun init_project.sh app-landing\nUse assets/templates/landing/ as base\nGenerate with Hero, Features, Pricing, CTA\nDeploy with deploy_github_pages.sh app-landing username\nTroubleshooting\nGitHub Pages Not Deploying\nCheck repository Settings → Pages → Source is set to gh-pages branch\nVerify GitHub Actions workflow ran successfully\nCheck DNS propagation (can take 5-10 minutes)\nPermission Errors\nEnsure gh CLI is authenticated: gh auth status\nCheck repository permissions on GitHub\nBuild Failures\nReview Actions logs in repository\nVerify .github/workflows/deploy.yml syntax\nCheck file paths and references\nResources\nscripts/\ninit_project.sh - Initialize project structure\ndeploy_github_pages.sh - Deploy to GitHub Pages\nreferences/\nworkflow.md - Detailed workflow documentation\ndesign-patterns.md - Design best practices\nassets/\ntemplates/base-html/ - Minimal HTML5 boilerplate\ntemplates/portfolio/ - Portfolio/CV template\ntemplates/landing/ - Landing page template\n.github/workflows/deploy.yml - GitHub Actions workflow template"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ThomekSolutions/web-deploy-github",
    "publisherUrl": "https://clawhub.ai/ThomekSolutions/web-deploy-github",
    "owner": "ThomekSolutions",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}