# Blogr

> Use this skill when the user wants to create, build, or manage a terminal-first blog or personal website using Markdown and static site generation.

- Skill: `javimosch/blogr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/blogr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/blogr/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/blogr

---


# blogr Plugin

Terminal-first blog and personal website generator. Write, edit, and publish your blog without ever leaving your terminal. Supports Markdown with YAML frontmatter, multiple themes, RSS feeds, full-text search, and static site builds.

## Commands

### Project Management
- `blogr project init` — Initialize a new blog or personal website
- `blogr project info` — Show project details

### Content Management
- `blogr content new` — Create a new blog post
- `blogr content list` — List all blog posts

### Site Generation
- `blogr site build` — Build the static site

### Utility
- `blogr self version` — Print blogr version
- `blogr _ _` — Passthrough to blogr CLI

## Usage Examples
- "Create a new blog project"
- "Create a personal website"
- "Add a new blog post titled 'Getting Started'"
- "List all posts in the blog"
- "Build the static site for deployment"
- "Show project configuration"

## Installation

```bash
cargo install blogr-cli
```

## Examples

```bash
# Initialize a new blog
blogr project init my-blog

# Initialize a personal website
blogr project init --personal my-portfolio

# Create a new blog post
blogr content new "Hello World"

# List all posts
blogr content list

# Build the static site
blogr site build

# Show project info
blogr project info

# Switch theme
blogr _ _ theme set minimal-retro
```

## Key Features
- Two site types: Blog mode and Personal/Portfolio mode
- Markdown posts with YAML frontmatter
- 8 built-in themes for blogs and personal sites
- Full-text search with MiniSearch integration
- Syntax highlighting for code blocks
- MathJax support for LaTeX math expressions
- RSS/Atom feeds (blog mode)
- SEO-friendly output
- Draft and published post management
- Tag-based organization
- Automatic slug generation
- External post support (link to posts hosted elsewhere)

## Notes
- `blogr serve` starts a live-reload dev server (run directly, not via supercli)
- `blogr edit` opens the built-in terminal editor (run directly, not via supercli)
- `blogr config edit` opens the interactive configuration editor (run directly, not via supercli)
- `blogr deploy` requires a GITHUB_TOKEN environment variable
- All project, content, and build commands are headless and safe for supercli