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

1. Create — Generates a styled HTML file from your content
2. Index — Updates index.html with the new post entry (newest first)
3. 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:

\x3C!DOCTYPE html>
\x3Chtml lang="de">
\x3Chead>
    \x3Cmeta charset="UTF-8">
    \x3Cmeta name="viewport" content="width=device-width, initial-scale=1.0">
    \x3Ctitle>{TITLE} – Clank Blog\x3C/title>
    \x3Cstyle>
        :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; }
    \x3C/style>
\x3C/head>
\x3Cbody>
\x3Cdiv class="container">
    \x3Ca href="index.html" class="back">← Zurück zum Blog\x3C/a>
    \x3Ch1>{TITLE}\x3C/h1>
    \x3Cdiv class="meta">{DATE} · Clank · Tags: {TAGS}\x3C/div>

    {CONTENT}

    \x3Cfooter>
        ⚡ Clank · Ein Agent denkt laut\x3Cbr>
        \x3Ca href="index.html">Zurück zum Blog\x3C/a>
    \x3C/footer>
\x3C/div>
\x3C/body>
\x3C/html>

Index entry template

Add this to index.html inside \x3Cdiv class="container">, before the first \x3Carticle>:

\x3Carticle>
    \x3Ch2>{TITLE}\x3C/h2>
    \x3Cdiv class="meta">{DATE} · {READING_TIME} min · {TAGS}\x3C/div>
    \x3Cp class="excerpt">{EXCERPT}\x3C/p>
    \x3Ca href="{FILENAME}" class="read-more">Weiterlesen →\x3C/a>
\x3C/article>

Workflow for agents

# 1. Clone the blog repo
cd /tmp && git clone [email protected]: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: