jekyll

Configure Jekyll url/baseurl values and SEO meta tags for GitHub Pages.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/hschne/pi-stuff --skill jekyll
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jekyll
Source: https://github.com/hschne/pi-stuff/tree/main/skills/jekyll
Command: npx skills add https://github.com/hschne/pi-stuff --skill jekyll

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chromium, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Jekyll static sites and blogs frequently suffer from broken asset links, missing or incorrect social media previews, and SEO misconfigurations caused by incorrect url/baseurl settings, improper URL filtering, or missing meta tags, especially when deploying to GitHub Pages or custom domains.

Core Features & Use Cases

  • End-to-end Jekyll scaffolding: Set up new Jekyll projects with correct Gemfile, Bundler configuration, and dependency management for both native GitHub Pages builds and custom GitHub Actions workflows.
  • URL and asset path configuration: Eliminate broken links and 404s by correctly setting url/baseurl values and using Liquid relative_url/absolute_url filters for all internal assets and links.
  • SEO and social preview setup: Wire up jekyll-seo-tag, Open Graph/Twitter card metadata, sitemap, and feed plugins to ensure proper search engine indexing and correct social sharing previews across Facebook, X/Twitter, and LinkedIn.
  • Use case example: If you are launching a personal blog on GitHub Pages, this skill ensures your social previews render correctly, your CSS and JS load in production, and your site passes basic SEO checks without manual tag tweaking.

Quick Start

Use the jekyll skill to scaffold a new Jekyll blog configured for GitHub Pages deployment with working social previews and correct asset paths.

Frequently Asked Questions about jekyll

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

FAQPage Schema
How do I fix broken social media previews on my Jekyll GitHub Pages site?

Fix broken Jekyll social previews by correctly configuring jekyll-seo-tag and emitting valid Open Graph and Twitter Card metadata in your site's head. This ensures platforms like Facebook and LinkedIn render the correct title, description, and image when sharing URLs.

Why are my CSS and JS assets returning 404 errors after deploying Jekyll to a custom domain?

Jekyll asset 404s on custom domains usually stem from incorrect _config.yml url and baseurl values. Setting these correctly and using Liquid relative_url or absolute_url filters for internal links resolves broken asset paths during deployment.

How do I scaffold a new Jekyll static site with Bundler for GitHub Actions?

Scaffold a new Jekyll static site by setting up the project with a correct Gemfile and Bundler configuration. This manages dependencies for reproducible builds whether deploying natively through GitHub Pages or using custom GitHub Actions workflows.

Does jekyll-seo-tag automatically generate Open Graph tags for static site blogs?

Yes, jekyll-seo-tag automatically generates Open Graph and Twitter card metadata for Jekyll static sites. Wiring this plugin into your configuration ensures proper search engine indexing and compliant social sharing previews without manual tag tweaking.

What is the best way to configure baseurl for a Jekyll project deployed to GitHub Pages?

The best way to configure baseurl for Jekyll on GitHub Pages is setting the correct url and baseurl values in _config.yml. Using Liquid relative_url filters for internal assets ensures links resolve properly across root and project-level deployments.