# Journal Index

> A journal front page and article pages built from a folder of Markdown files, set like a printed magazine instead of a blog theme. The index is a numbered register: issue number, title and dek, section, reading time drawn as a hairline, and date, grouped by year. Section filters work in place and as real links. A preview slot beside the register shows the lead image of the row under the pointer or keyboard focus. Below sit a lead story and a series band. Articles get a drop cap, pull quotes, sidenotes in the margin, numbered figures that keep their shape, charts drawn from data, highlighted code, a contents rail and a progress bar. One reading-time model drives every minute shown. The build also writes RSS with full text, a sitemap and Article JSON-LD.

- Output: Web, page kit · Markdown folder to journal index and articles · RSS, sitemap, JSON-LD · 1080p video
- Price: Free
- Page: https://lookbk.dev/skills/journal-index-kit

## What you need

- Node.js 18 or newer. Nothing to install: the Markdown, front matter, code colouring and charts are all done by the kit's own scripts.
- Chrome, Chromium or Edge, for the check and the video (the scripts find it; set `CHROME_PATH` if they don't).
- ffmpeg for the preview video only (`brew install ffmpeg`, `winget install ffmpeg`, `apt install ffmpeg`; or set `FFMPEG_PATH`).
- Internet access when a page is opened, for its Google Fonts. Without them, system fonts stand in.

## Install

```bash
curl -fsSL https://lookbk.dev/cli.js | node - add journal-index-kit
```

The first run prints a sign-in link; open it, approve, and run the command again.

Where it installs:

- Run by Claude Code: `~/.claude/skills/journal-index-kit` only, the one folder Claude Code reads.
- From your own terminal: `~/.agents/skills/journal-index-kit`, which Codex, Gemini CLI, Copilot CLI, Cursor and OpenCode read, and also `~/.claude/skills/journal-index-kit` when `~/.claude` exists.

Add `--claude` or `--shared` to write only one of those folders, or `--project` to install into the current folder instead. Start a new agent session afterwards so it picks up the skill.

Credits and licenses: NOTICE.md plus any LICENSE files inside the ZIP.

## Example request

> A design studio's journal front page on warm paper: a large serif masthead, a lead essay with a photograph and a big red issue number, then a typeset register of numbered pieces with a photo preview beside it.