Creating a TIL section using Nextra’s blog example

---
name: create-til-post
description: Create a new TIL (Today I Learned) post for the personal website repo using the Nextra blog example structure. Use when Cleo needs to (1) review a specific day’s message history/memory to find learnings, (2) ask Marc to confirm the agenda/topics, (3) draft and publish the post as a GitHub PR by adding a new MDX file under app/til/YYYY-MM-DD-*/page.mdx, and (4) share the PR link back to Marc via WhatsApp.
---
 
# Create TIL Post
 
Create a daily, replicable TIL post in the personal website repo.
 
## Hard constraints
 
- **Ask Marc before creating a new TIL post.** (Agenda approval first.)
- **Do not include personal information about Marc.** Write only about Cleo’s discoveries.
- Posts live in the repo under: `app/til/YYYY-MM-DD-your-title/page.mdx`.
 
## Workflow
 
### 0) Locate the repo + styleguide
 
- Repo (default): `/root/.openclaw/workspace/repos/personal-website`
- Styleguide: read `AGENTS.md` in that repo and follow the “Styleguide” section.
 
### 1) Derive candidate learnings for a given day
 
Goal: produce 5–10 **high-level topics** to propose to Marc.
 
Use a mix of:
 
- **OpenClaw memory** (if available): `memory/YYYY-MM-DD.md` (today + the target day)
- **Git evidence** (always available):
  - `git log --since "YYYY-MM-DD 00:00" --until "YYYY-MM-DD 23:59" --oneline`
  - merged PR titles (via `gh pr list --state merged` or repo UI)
- **What you actually ran**: terminal commands in this chat/session (summarize, do not paste secrets)
 
Output at this stage: a short agenda proposal (bullets), not the full post.
 
### 2) Ask Marc to confirm the agenda/topics (WhatsApp)
 
Send Marc a message with:
 
- Date
- Proposed title (1 option)
- 5–10 topic bullets
- Ask: “Approve as-is or add comments?”
 
Do **not** draft/publish the post until Marc approves.
 
### 3) Draft the post (use the house template)
 
Follow the styleguide’s template:
 
- Verb-first, searchable H1
- 1–3 sentence opener (“Today I learned…”)
- Short context
- A copy/pastable recipe (commands/code)
- Notes/gotchas
- Links
 
Privacy check:
 
- No names, schedules, locations, phone numbers, private URLs, or personal anecdotes about Marc.
 
### 4) Publish via PR
 
Use the helper script:
 
- `scripts/create_til_pr.py`
 
### 5) Share PR link back
 
Send the PR URL and a one-liner summary.

#!/usr/bin/env python3
 
from __future__ import annotations
 
import argparse
import os
import re
import subprocess
from pathlib import Path
 
 
def run(cmd: list[str], cwd: Path, check: bool = True) -> subprocess.CompletedProcess:
    return subprocess.run(cmd, cwd=str(cwd), text=True, capture_output=True, check=check)
 
 
def slugify(s: str) -> str:
    s = s.strip().lower()
    s = re.sub(r"[^a-z0-9\s-]", "", s)
    s = re.sub(r"[\s_-]+", "-", s)
    s = re.sub(r"^-+|-+$", "", s)
    return s
 
 
def main() -> int:
    ap = argparse.ArgumentParser()
    ap.add_argument(
        "--repo",
        default=os.environ.get(
            "PERSONAL_WEBSITE_REPO", "/root/.openclaw/workspace/repos/personal-website"
        ),
    )
    ap.add_argument("--date", required=True, help="YYYY-MM-DD")
    ap.add_argument("--slug")
    ap.add_argument("--title", required=True)
    ap.add_argument("--description", required=True)
    ap.add_argument("--tags", nargs="*", default=[])
    ap.add_argument("--author", default="Cleo von Neumann")
    ap.add_argument("--body-file", required=True)
    ap.add_argument("--branch")
    ap.add_argument("--base", default="main")
    ap.add_argument("--no-build", action="store_true")
 
    args = ap.parse_args()
 
    repo = Path(args.repo)
    body = Path(args.body_file).read_text(encoding="utf-8").rstrip() + "\n"
 
    slug = args.slug or f"{args.date}-{slugify(args.title)}"
    if not re.match(r"^\d{4}-\d{2}-\d{2}-", slug):
        slug = f"{args.date}-{slug}"
 
    branch = args.branch or f"til/{slug}"
 
    post_dir = repo / "app" / "til" / slug
    post_dir.mkdir(parents=True, exist_ok=True)
    post_file = post_dir / "page.mdx"
 
    tags = ", ".join(args.tags)
    tags_str = f"[{tags}]" if tags else "[]"
 
    # NOTE: this line should be adjusted if you don't want a public repo link in posts.
    content = (
        "---\n"
        f"title: {args.title}\n"
        f"date: {args.date}\n"
        f"description: {args.description}\n"
        f"tags: {tags_str}\n"
        f"author: {args.author}\n"
        "---\n\n"
        "Repo: <REPO URL HERE>\n\n"
        + body
    )
 
    post_file.write_text(content, encoding="utf-8")
 
    run(["git", "checkout", args.base], cwd=repo)
    run(["git", "pull"], cwd=repo)
    run(["git", "checkout", "-b", branch], cwd=repo)
 
    run(["git", "add", str(post_file.relative_to(repo))], cwd=repo)
    run(["git", "commit", "-m", f"docs(til): {slug}"], cwd=repo)
 
    if not args.no_build:
        run(["npm", "run", "build"], cwd=repo)
 
    run(["git", "push", "-u", "origin", branch], cwd=repo)
 
    cp = run(
        [
            "gh",
            "pr",
            "create",
            "--title",
            f"docs(til): {args.title}",
            "--body",
            f"Adds TIL post for {args.date}.",
            "--base",
            args.base,
            "--head",
            branch,
        ],
        cwd=repo,
    )
 
    print((cp.stdout or "").strip())
    return 0
 
 
if __name__ == "__main__":
    raise SystemExit(main())

# Privacy checklist (TIL posts)
 
Before opening the PR, confirm:
 
- [ ] No personal information about Marc
- [ ] No phone numbers, addresses, calendars, travel plans, private links, or screenshots
- [ ] No secrets (tokens, keys, passwords)
- [ ] No internal machine identifiers (hostnames, IPs) unless explicitly intended
- [ ] Commands shown are safe and don’t include credentials