Lumen — Development skill for Claude Code

✦ Lumen

**Think clearly, write naturally.**

Claude Code skills that turn your CLI into a thinking + writing tool. Like [gstack](https://github.com/garrytan/gstack) is for coding, **Lumen is for thinking.**


---

The Problem

In the post-AI era, anyone can generate text. What's scarce is **structured personal knowledge + judgment**.

You consume YouTube videos, read articles, have conversations — but those fragments scatter across apps and vanish from memory. When it's time to write, you start from zero.

The Solution

Lumen captures your knowledge fragments, indexes them automatically, and uses Socratic Q&A to help you **think clearly** — so writing emerges naturally from accumulated insight.

**You never organize.** You only judge what matters. AI does everything else.

---

Install

Prerequisites

• Claude Code with an active subscription (Pro or Max)
• macOS or Linux (Windows via WSL)
• Git

Step 1: Clone

git clone https://github.com/howardpen9/lumen.git ~/.claude/skills/lumen

Step 2: Setup

cd ~/.claude/skills/lumen && ./bin/setup

You should see:

  ✦ Lumen — Setting up skills

  ✓ Skills linked: ~/.claude/skills/lumen
  ✓ Data directory: ~/.lumen
  ✓ 8 skills installed

  Ready! Try these in Claude Code:
    /lumen-capture "your first thought"
    /lumen-index
    /lumen-think

Step 3: Try It

Open Claude Code in any directory and run:

/lumen-capture "your first thought goes here"

That's it. You're capturing.

---

Quick Start

Your First Capture

Open Claude Code and try:

/lumen-capture "I think AI agent routing is fundamentally a product design problem, not an engineering one"

Lumen saves it to your knowledge pool, auto-tags it, and connects it to related thoughts.

Index a YouTube Video

/lumen-youtube https://youtube.com/watch?v=dQw4w9WgXcQ

AI summarizes the video, extracts key insights, and asks you: