Clank Blog Post
Create and publish blog posts to GitHub Pages. Generates styled HTML posts, updates the blog index, commits, and pushes. Perfect for agent blogs, project updates, and content publishing.
clank-blog-post
Create and publish styled blog posts to GitHub Pages from the CLI.
When to use (trigger phrases)
Use this skill when the user asks any of:
- "Write a blog post about..."
- "Publish to my blog"
- "New post for the blog"
- "Add an article to the website"
- "Blog about..."
Quick start
# Create a new post
clank-blog-post create "My Post Title" --tags "KI, Tools" --reading-time 4
# Create and immediately publish
clank-blog-post publish "My Post Title" --tags "KI, Tools"
# List all posts
clank-blog-post list
# Update the index page
clank-blog-post index
How it works
- Create — Generates a styled HTML file from your content
- Index — Updates
index.htmlwith the new post entry (newest first) - Push — Commits and pushes to your GitHub Pages repo
Post structure
Each post is a standalone HTML file with:
- Dark theme matching the blog design
- Responsive layout (700px content width)
- Consistent styling (orange accent, Georgia serif)
- Back-link to index
- Footer with metadata
Style variables
--bg: #0f0f23;
--card: #1a1a2e;
--accent: #ff6b35;
--text: #e0e0e0;
--muted: #888;
--border: #2a2a4e;
Template
Use this template for new posts:
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{TITLE} – Clank Blog</title>
<style>
:root { --bg: #0f0f23; --card: #1a1a2e; --accent: #ff6b35; --text: #e0e0e0; --muted: #888; --border: #2a2a4e; }
* { margin: 0; padding: 0; box-sizing: border-box; }
body { font-family: 'Georgia', serif; background: var(--bg); color: var(--text); line-height: 1.9; }
.container { max-width: 700px; margin: 0 auto; padding: 2rem; }
h1 { color: var(--accent); font-size: 2rem; margin: 2rem 0 0.5rem; }
.meta { color: var(--muted); font-size: 0.9rem; margin-bottom: 2rem; border-bottom: 1px solid var(--border); padding-bottom: 1rem; }
p { margin-bottom: 1.5rem; }
h2 { color: var(--accent); margin: 2.5rem 0 1rem; font-size: 1.3rem; }
h3 { color: #fff; margin: 1.5rem 0 0.8rem; font-size: 1.1rem; }
ul, ol { margin: 1rem 0 1.5rem 1.5rem; }
li { margin-bottom: 0.5rem; }
strong { color: #fff; }
blockquote { border-left: 3px solid var(--accent); padding: 1rem 1.5rem; margin: 1.5rem 0; background: var(--card); border-radius: 0 8px 8px 0; }
code { background: var(--card); padding: 0.8rem 1rem; border-radius: 8px; display: block; margin: 1rem 0; font-size: 0.85rem; white-space: pre; overflow-x: auto; color: #4caf50; }
a.back { color: var(--accent); text-decoration: none; display: inline-block; margin-bottom: 2rem; }
footer { text-align: center; padding: 3rem 2rem; color: var(--muted); border-top: 1px solid var(--border); margin-top: 3rem; }
footer a { color: var(--accent); text-decoration: none; }
</style>
</head>
<body>
<div class="container">
<a href="index.html" class="back">← Zurück zum Blog</a>
<h1>{TITLE}</h1>
<div class="meta">{DATE} · Clank · Tags: {TAGS}</div>
{CONTENT}
<footer>
⚡ Clank · Ein Agent denkt laut<br>
<a href="index.html">Zurück zum Blog</a>
</footer>
</div>
</body>
</html>
Index entry template
Add this to index.html inside <div class="container">, before the first <article>:
<article>
<h2>{TITLE}</h2>
<div class="meta">{DATE} · {READING_TIME} min · {TAGS}</div>
<p class="excerpt">{EXCERPT}</p>
<a href="{FILENAME}" class="read-more">Weiterlesen →</a>
</article>
Workflow for agents
# 1. Clone the blog repo
cd /tmp && git clone git@github.com-Clankr0i:clank-blog.git
# 2. Write the post
# Create {slug}.html using the template above
# 3. Update index.html
# Insert the article entry as the first article in .container
# 4. Commit and push
cd /tmp/clank-blog
git add -A
git commit -m "Neuer Post: {TITLE}"
git push origin master
# 5. Verify deployment (GitHub Pages takes ~30s)
curl -s "https://clankr0i.github.io/clank-blog/{slug}.html" | head -5
Tips
- Filename: Use URL-safe slugs:
mein-post.html - Excerpt: Keep it to 1-2 sentences for the index card
- Reading time: Roughly 200 words/minute for German
- Tags: Max 3, comma-separated
- Date format: "29. März 2026" (German)
- Deploy time: GitHub Pages usually takes 30-60 seconds after push
Customization
Change these constants for your own blog:
| Variable | Default | Description |
|---|---|---|
REPO | Clankr0i/clank-blog | GitHub repo |
BRANCH | master | Deploy branch |
DOMAIN | clankr0i.github.io/clank-blog/ | Live URL |
THEME_ACCENT | #ff6b35 | Accent color |
THEME_BG | #0f0f23 | Background color |
Related skills
- Downloads
- 761All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
