github-pages-publisher

Automates publishing Markdown articles to GitHub Pages with Jekyll compatibility and git push.

2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/imsatoshi/bot_article --skill github-pages-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pages-publisher
Source: https://github.com/imsatoshi/bot_article/tree/main/skills/github-pages-publisher
Command: npx skills add https://github.com/imsatoshi/bot_article --skill github-pages-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill removes the repetitive, error-prone work of manually committing blog posts, maintaining Jekyll-compatible front matter, organizing category folders, and updating your README/index for a GitHub Pages site.

Core Features & Use Cases

  • Automated publish workflow: Runs git add/commit/push end-to-end so new articles appear on GitHub Pages with minimal manual steps.
  • Jekyll-ready article formatting: Generates or validates Jekyll-compatible front matter (layout, title, date, categories, tags) and supports permalink generation for stable URLs.
  • Content organization & indexing: Maintains category directories (ai/crypto/tech/twitter) and auto-updates README-based indexes so readers can navigate quickly.

Quick Start

Use the command “python3 {baseDir}/scripts/publish_article.py --title 'Your Article Title' --category ai --tags '["AI","Agent"]' --content '# Your Markdown content'” to publish a new Jekyll-compatible post into the ai category and push it to your GitHub Pages repository.

Frequently Asked Questions about github-pages-publisher

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

FAQPage Schema
How do I automatically publish markdown articles to GitHub Pages?

To automatically publish markdown articles to GitHub Pages, you can use a script that generates Jekyll front matter, places files into category directories, and runs git add, commit, and push commands. This workflow ensures new posts appear online with minimal manual steps.

Does publishing to Jekyll require manually creating front matter for each post?

Publishing to Jekyll does not require manually creating front matter. The automation generates and validates Jekyll-compatible front matter, including layout, title, date, categories, and tags, while formatting permalink-safe URLs for stable links.

What is the best way to maintain category directories and index pages for a Jekyll site?

The best way to maintain category directories and index pages is through automated content indexing. The workflow organizes posts into specific directories like ai or crypto and automatically updates the README-based index so readers can navigate quickly.

Can I batch-add multiple curated posts to GitHub Pages at once?

Yes, you can batch-add multiple curated posts to GitHub Pages at once. The workflow supports batch-adding posts for curated digests while keeping stable permalinks and automatically updating category indexes across your repository.

Do I need Git credentials to automate article publishing with Python?

Yes, you need Git and GitHub credentials to automate article publishing with Python. The scripts require these credentials to perform git add, commit, and push operations to publish content directly to your GitHub Pages repository.