Normalize Format

Normalizes a single inbox file of any supported format (plain markdown, Claude.ai JSON export, Claude Code JSONL session, Readwise markdown/CSV highlight, transcript with timestamps or speaker labels, link capture) into a clean markdown body plus partial frontmatter (id, title, source block, word_count). Handles format-specific failure modes — JSON content-block arrays, timestamp stripping, per-highlight chunking, URL-vs-commentary separation. Use when ingesting any inbox item for the substacker Librarian. Trigger keywords — normalize, convert, parse, transcript, export, JSON, JSONL, highlight

200 stars 25 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add lyndonkl/claude

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add lyndonkl/claude --skill normalize-format
Manual install
git clone --depth 1 https://github.com/lyndonkl/claude.git /tmp/claude
mkdir -p ~/.claude/skills
cp -r /tmp/claude/skills/normalize-format ~/.claude/skills/normalize-format

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Normalize Format

## Table of Contents

- [Supported formats](#supported-formats)
- [Workflow](#workflow)
- [Detection heuristics](#detection-heuristics)
- [Worked example](#worked-example)
- [Guardrails](#guardrails)

**Related skills:** Called by `ingest-inbox-item` as step 1. Upstream of `tag-by-topic`, `score-intuition-density`, `dedupe-against-corpus`.

## Supported formats

| Extension | Format | Notes |
|---|---|---|
| `.md`, `.txt` | plain markdown | Default; passes through |
| `.json` | Claude.ai export | Conversation with messages array |
| `.jsonl` | Claude Code session | Content-block array per response |
| `.md` (Readwise-shaped) | Readwise export | Highlights + user notes |
| `.csv` | Readwise CSV | Per-row highlight |
| `.vtt`, `.srt`, `.md` (diarized) | Transcript | May include timestamps + speaker labels |
| `.md` with URL + commentary | Link capture | User's framing is the signal |

## Workflow

```
Normalize one file:
- [ ] Step 1: Detect format by extension + first-line sniff
- [ ] Step 2: Apply format-specific parse
- [ ] Step 3: Split long transcripts at topic boundaries (>3000 words)
- [ ] Step 4: Emit [{body, partial_frontmatter}, ...] list (usually one item)
```

### Step 1: Detection

- `.jsonl` with `"type":"assistant"` → Claude Code session.
- `.json` with `"conversation"` / `"messages"` top-level key → Claude.ai export.
- `.md` starting with `# ` and Readwise boilerplate (`**Highlights first synced by Readwise...**`) → Readwise.
Read the full skill on GitHub

Details

Skill name
normalize-format
Path
skills/normalize-format/SKILL.md
Repo updated
1 September 2026

FAQ

What does the Normalize Format skill do?

Normalizes a single inbox file of any supported format (plain markdown, Claude.ai JSON export, Claude Code JSONL session, Readwise markdown/CSV highlight, transcript with timestamps or speaker labels, link capture) into a clean markdown body plus partial frontmatter (id, title, source block, word_count). Handles format-specific failure modes — JSON content-block arrays, timestamp stripping, per-highlight chunking, URL-vs-commentary separation. Use when ingesting any inbox item for the substacker Librarian. Trigger keywords — normalize, convert, parse, transcript, export, JSON, JSONL, highlight

How do I install the Normalize Format skill?

Claude Code plugin: /plugin marketplace add lyndonkl/claude. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Normalize Format popular?

It lives in lyndonkl/claude, which has 200 GitHub stars and 25 forks.

Related skills

Abstraction Concrete Examples

200

lyndonkl/claude

Builds structured abstraction ladders that translate high-level principles into concrete, actionable examples across 3-5 levels. Bridges communication gaps, reveals hidden assumptions, and tests whether abstract ideas work in practice. Use when explaining concepts at different expertise levels, moving between abstract principles and concrete implementation, identifying edge cases by testing ideas against scenarios, designing layered documentation, decomposing complex problems into actionable steps, or bridging strategy-execution gaps.

Testing & QA25

Academic Letter Architect

200

lyndonkl/claude

Guides the creation of evidence-based academic recommendation letters, reference letters, and award nominations that combine concrete examples, meaningful comparisons, and genuine enthusiasm. Use when writing recommendation letters for students, postdocs, or colleagues, or when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy and comparative statements.

Research & Science25

Adr Architecture

200

lyndonkl/claude

Documents significant architectural and technical decisions with full context, alternatives considered, trade-offs analyzed, and consequences understood. Creates a decision trail that helps teams understand why decisions were made. Use when choosing between technology options, making infrastructure decisions, establishing standards, migrating systems, or when user mentions ADR, architecture decision, technical decision record, or decision documentation.

Software Development25

Opponent Archetype Classifier

200

lyndonkl/claude

Classifies an opposing player, manager, or agent into one of a configurable archetype set using Bayesian inference over observed behavior (roster composition, transaction pattern, lineup moves, trade activity). Domain-neutral scaffold -- callers supply the archetype taxonomy (names, priors, characteristic feature distributions) and observed features; the skill returns a normalized posterior, MAP archetype, classification confidence, feature-contribution breakdown, and best-response hints. Use when modeling opponents, classifying player types, performing Bayesian archetype inference, producing

AI, LLMs & Agents25

Narrative Fidelity Audit

200

lyndonkl/claude

Runs the hard gate on invention in fact-based narrative — a bright-line refusal sweep, an interior-state provenance ladder ([A] said-so / [B] contemporaneous document / [C] behavioural inference / [D] unsourced, where any [D] blocks publication), an LLM-specific fabrication red-flag scan, a three-altitude "How do you know?" prosecution at sentence, paragraph and passage level, a subtraction-log set review, and a note on sources generated from the deviation log. Use before shipping any narrative built on real evidence — market history, incident post-mortem, biography, ML writeup, supply-chain r

AI, LLMs & Agents25

Poteto Mode

100

adriannoes/awesome-agentic-ai

poteto's agent style for concise, detailed responses, deliberate subagents, unslopped prose, simple code, and verified work. Use for poteto, /poteto-mode, or requests to work in this style.

AI, LLMs & AgentsIn 2 lists27

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.