MkDocs-based personal blog with AI content automation for Claude Code
This skill has safety concerns that you should review before use. Some patterns were detected that may pose a risk.Safety score: 60/100.
KillerSkills scans all public content for safety. Use caution before installing or executing flagged content.
Development workflow for Jason Liu's personal blog and consulting website built with MkDocs Material. Includes AI-powered SEO automation, link management, and content generation tools.
This skill provides guidance for working with a technical blog that features AI/ML content, consulting services, RAG education courses, and personal writing. The site uses MkDocs Material for static site generation with custom automation scripts.
```bash
uv pip install -r requirements-doc.txt
mkdocs serve
mkdocs build
./build_mkdocs.sh
python check_links.py # Verify all markdown links
python generate_sitemap.py # Generate SEO sitemap with AI summaries
python generate_desc.py # Add AI-generated descriptions to posts
```
**Static Site Generation:**
**Content Structure:**
**Automation Tools:**
1. Create markdown file in `docs/writing/posts/`
2. Add frontmatter with required fields:
- date
- authors
- description
- categories
- draft status
3. Run `python generate_desc.py` to generate AI descriptions if needed
4. Verify links with `python check_links.py`
5. For external links, generate shortlinks with proper tagging
Always use the shortlinks CLI when adding external links to blog posts:
```bash
uv run python scripts/shortlinks.py "https://example.com" \
--title "Descriptive Title" \
--desc "Short description" \
--tags "tag1,tag2" \
--external-id "unique-id-for-link" \
--blog-tag "blog-slug-name"
```
The `--blog-tag` option is required and should match the blog post's slug or filename for analytics tracking.
**Structure:**
1. Core insights upfront
2. Glossary of key terms
3. Concrete examples
4. Actionable next steps
**Opening Format:**
**Subheadings:**
**Citations:**
**Key Themes:**
**Tone:**
**Consulting Attribution:**
**Cross-linking:**
**Context Engineering Series:**
**Blog Post Titles:**
**Blog Post Frontmatter:**
```yaml
---
date: YYYY-MM-DD
authors:
- author-id
description: Brief description (can be AI-generated)
categories:
- Category Name
draft: false
---
```
**Internal Linking:**
**SEO Optimization:**
1. **Before writing:** Review series positioning and related posts
2. **While writing:** Follow structure and tone guidelines, use shortlinks for external URLs
3. **After writing:** Run SEO scripts, verify links, optimize cross-references
4. **Before publishing:** Test with `mkdocs serve`, verify frontmatter, check draft status
5. **Publishing:** Build site with `mkdocs build` or `./build_mkdocs.sh`
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/jxnl-blog-development/raw