| name | copy-graham-blog-post |
| description | Copies blog posts from Graham Dumpleton's blog (grahamdumpleton.me GitHub repo) to the Educates blog in this repo, rewriting first person singular to first person plural (we, the Educates team). Use when the user wants to copy, migrate, or add a post from Graham's blog to the educates site, or when given a GitHub URL to a post folder under GrahamDumpleton/grahamdumpleton.me. |
Copy Graham blog post to Educates site
Copy a post (and its images) from Graham Dumpleton's blog repo into this repo's blog/ folder, and rewrite the text from first person singular (I, my) to first person plural (we, our) as the Educates team.
Source and target
- Source: GitHub repo
GrahamDumpleton/grahamdumpleton.me, path like src/posts/YYYY/MM/post-slug/ (e.g. src/posts/2026/02/deploying-educates-yourself).
- Target: This repo's
blog/ folder. Create a folder named YYYY-MM-DD-<slug>/ (e.g. 2026-02-26-deploying-educates-yourself) containing index.md and any image files. Use the post's date from frontmatter for the folder date, or the path date if needed. Add <!--truncate --> after first paragraph. If first paragraph is too short, do it after the second. Also, review the tags to align with those in blog/tags.yaml and the topic in the blog.
Workflow
1. List source files
Call GitHub Contents API to list files in the post folder:
GET https://api.github.com/repos/GrahamDumpleton/grahamdumpleton.me/contents/src/posts/YYYY/MM/<post-slug>
Or use curl -sL "https://api.github.com/repos/...". From the response, identify index.md and any image files (e.g. .png, .jpg). Ignore .DS_Store and non-content files.
2. Fetch post content
Download the raw markdown:
https://raw.githubusercontent.com/GrahamDumpleton/grahamdumpleton.me/main/src/posts/YYYY/MM/<post-slug>/index.md
Use curl -sL "<url>" if needed (mcp_web_fetch may timeout).
3. Rewrite voice (first person singular → plural)
In the body (not code blocks or image alt text unless they are first-person narrative), replace:
| Original (Graham, singular) | Rewritten (Educates team, plural) |
|---|
| In my [last/previous] post | In our [last/previous] post |
| I showed / I walked / I pointed / I had to / I find / I have / I'm / I noticed / I tried / I could / I couldn't | we showed / we walked / we pointed / we had to / we find / we have / we're / we noticed / we tried / we could / we couldn't |
| my previous post / my last post | our previous post / our last post |
| being the author of the Educates platform | being the team behind the Educates platform |
| as far as I'm aware | as far as we're aware |
| I'd told it | we'd told it |
Preserve "you" when addressing the reader. Do not change technical wording, code blocks, or link URLs except internal post links.
4. Adapt frontmatter
- Keep:
title, description, date, tags, image, draft.
- Add:
slug: <post-slug> (e.g. deploying-educates-yourself).
- Add:
authors: [graham].
- Remove any frontmatter fields this site does not use (check existing posts in
blog/ for the schema).
- Remove
daft and date frontmatter fields.
5. Fix internal links
Replace Graham's post paths with this site's blog paths:
/posts/YYYY/MM/slug/ or /posts/2026/02/teaching-an-ai-about-educates/ → /blog/<slug> (e.g. /blog/teaching-an-ai-about-educates).- Use
/blog/<slug> consistently (no trailing slash required; add one if the site expects it).
6. Adjust tags
- Review tags in frontmatter section to align with the contents of the blog post and tags already defined in
blog/tags.yaml
6. Create target folder and files
- Create
blog/YYYY-MM-DD-<slug>/ (e.g. blog/2026-02-26-deploying-educates-yourself/).
- Write the rewritten content to
blog/YYYY-MM-DD-<slug>/index.md.
- Download each image from
https://raw.githubusercontent.com/GrahamDumpleton/grahamdumpleton.me/main/src/posts/YYYY/MM/<post-slug>/<filename> into the same folder. Image references in the markdown are relative (e.g. training-portal.png), so they resolve correctly.
7. Verify
- Confirm all images are present and paths in markdown match filenames.
- Spot-check that first-person singular in the body has been converted to plural and internal links use
/blog/....
Example
User provides: https://github.com/GrahamDumpleton/grahamdumpleton.me/tree/main/src/posts/2026/02/deploying-educates-yourself
- Post slug:
deploying-educates-yourself.
- List contents → get
index.md, training-portal.png, workshop-dashboard.png.
- Fetch
index.md, rewrite I/my → we/our, add slug and authors: [graham], change link to previous post to /blog/teaching-an-ai-about-educates.
- Create
blog/2026-02-26-deploying-educates-yourself/index.md and download the two PNGs into that folder.
Reference: existing Educates post frontmatter
---
title: "..."
slug: post-slug
description: "..."
date: YYYY-MM-DD
tags: ["educates", "ai"]
authors: [graham]
image: https://opengraph.githubassets.com/1/educates/educates-training-platform
draft: false
---
Authors are defined in blog/authors.yml; graham exists. Use the same structure for new posts.
