This morning I decided to set aside 2 hours to create a new blog. I knew I wanted to use GitHub Pages and Claude Code.
My requirements were:
With that figured out, I told Claude Code to get to work.
Here’s exactly what I asked Claude Code to get this whole process started:
“I want to setup a github blog. I think I can do it from a github repo (that I’m currently in). If that’s true, help me set it up. Also create the first blog post, which documents how I set it up using Claude Code”
That single prompt kicked off the process and created the blog you’re reading now. All I did was answer some questions and update the outputed post (so it wasn’t AI slop). The outline, images, tags, etc, were all done by Claude Code.
Here’s how Claude Code helped me set up this blog:
Claude Code started by examining my existing repository structure. I already had a partial Jekyll setup with:
_config.yml fileindex.md with useful development toolsI could’ve started from scratch with no Jekyll config or anything setup and Claude would’ve rolled with that, possibly even quicker. But I’d tried this before without Claude so here we were.
Claude Code enhanced my _config.yml with proper blog settings:
title: Jamie Houston's Blog
description: A blog about development tools, tips, and tech adventures
author: Jamie Houston
baseurl: ""
url: "https://jamie-houston.github.io"
# Build settings
markdown: kramdown
highlighter: rouge
theme: jekyll-theme-architect
# Plugins
plugins:
- jekyll-feed
- jekyll-sitemap
# Posts settings
permalink: /:categories/:year/:month/:day/:title:output_ext
I had some back and forth here looking at themes and figuring out what I wanted the UI to look like. Claude showed me where to look and gave me suggestions based on the styles and examples I said I liked.
The essential Jekyll directories were created:
_posts/ - Where blog posts live_layouts/ - Custom page layouts (if needed)The existing index.md was transformed from a simple tools list (my original use for this site) into a proper blog homepage that:
And here we are! This very post documents the setup process, creating a nice meta-documentation loop. I updated the bulk of the text to give it my voice (or, let’s be honest, a voice), but Claude did the outline and technical notes.
Claude created a Jekyll GitHub Actions workflow that will automatically build and deploy the site whenever I push changes. This means the blog is fully automated - I just need to write posts and push them to the repository (which I guess means I need to write more blog posts…)
AI is taking the world by storm. Some people are embracing it, some are running away and avoiding it, but most are just using the tip of the iceburg. A lot of my conversations with people about AI start with them saying “I don’t really see much use out of it” or “I’ve tried it for coding, but…”. My goal for this blog is to help them out. It’s not just for coding or research or simple tasks and questions. Anything you spend a bunch of time working on can likely be helped with AI and I hope to help you see that.