blog-publisher

Publish local Markdown files to GitHub Pages via the GitHub API.

1|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/maoruibin/blog-publisher --skill blog-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blog-publisher
Source: https://github.com/maoruibin/blog-publisher/tree/main
Command: npx skills add https://github.com/maoruibin/blog-publisher --skill blog-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of publishing local Markdown files to a GitHub Pages blog, transforming them into Jekyll-compatible posts.

Core Features & Use Cases

  • One-click Publishing: Publish articles with a single command.
  • Automatic Conversion: Converts your Markdown's frontmatter to Jekyll format.
  • Image Handling: Uploads local images to your GitHub repository.
  • Use Case: You've written a new blog post in a Markdown file (~/my-blog/posts/2023-10-27-my-new-article.md) and want to publish it to your Jekyll-powered GitHub Pages site.

Quick Start

Publish my blog post located at /Users/me/Documents/my-blog-post.md.

Frequently Asked Questions about blog-publisher

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

FAQPage Schema
How do I publish a local Markdown file to a GitHub Pages blog?

You can publish a local Markdown file to GitHub Pages by providing the file path to this Skill, which then converts the frontmatter to Jekyll format and pushes the post via the GitHub API.

How does Markdown frontmatter conversion work for Jekyll posts?

Markdown frontmatter conversion for Jekyll posts works by automatically transforming your local Markdown metadata into the Jekyll-compatible format required for GitHub Pages publishing.

Can I upload local images to my GitHub repository when publishing blog posts?

Yes, you can upload local images to your GitHub repository when publishing blog posts; this Skill handles image uploads directly to a specified repository directory during the publishing process.

Does this publishing automation support custom domains and configurable post directories?

Yes, this publishing automation supports custom domains and configurable post directories, allowing you to specify exact repository paths for your Jekyll-powered GitHub Pages site.

What is the best way to automate Jekyll post creation from existing Markdown files?

The best way to automate Jekyll post creation from existing Markdown files is using a one-click publishing command that handles frontmatter conversion and image uploads via the GitHub API.