# Install in 10 seconds:
curl -sSL https://raw.githubusercontent.com/TheNight-Watch/deepthink-skill/main/install.sh | bash

🧠 DeepThink

AI Thinking Coach for Claude Code

Stop letting AI think for you. Start thinking deeper with AI.

Install · How It Works · Commands · Setup Guide

---

🆕 What's New (v1.0.0)

• Three-stage workflow: Understand → Research → Socratic Thinking
• Three independent sources: X/Twitter (xurl) + Perplexity AI (2-round) + 11 curated RSS feeds
• Belief tracking: Records how your views evolve across thinking sessions
• Built-in setup wizard: /deepthink setup guides API key configuration
• Cross-session memory: Picks up where you left off, no context lost

---

🤔 The Problem

AI makes it easy to get answers. Too easy. You ask, it answers, you move on.

Over time, you stop forming your own opinions. You outsource judgment. You lose the muscle of deep thinking.

DeepThink flips the script: instead of giving you answers, it gives you better questions.

---

✨ What It Does

You pick a topic → DeepThink researches it → Then coaches your thinking

Three Stages

Stage	What Happens	Your Role
1. Understand	DeepThink asks why you care about this topic	Share your motivation
2. Research	Pulls insights from X/Twitter, Perplexity AI, and 11 curated RSS feeds	Sit back (async)
3. Think	Socratic questioning based on research findings	Think, argue, evolve

The magic is in Stage 3: DeepThink doesn't summarize — it challenges. It asks follow-up questions, presents counter-arguments, tracks how your beliefs evolve over time.

---

🚀 Quick Install

Option A: One-line install

curl -sSL https://raw.githubusercontent.com/TheNight-Watch/deepthink-skill/main/install.sh | bash

Option B: Tell Claude Code to install it

Paste this into Claude Code:

Install the DeepThink skill from https://github.com/TheNight-Watch/deepthink-skill — copy the skill/ folder to ~/.claude/skills/deepthink/ and the command/deepthink.md to ~/.claude/commands/deepthink.md, then create ~/.claude/deepthink-data/ with subdirectories topics/, research/, sessions/ and an index.json containing {"topics":[]}.

Option C: Manual install

# Clone
git clone https://github.com/TheNight-Watch/deepthink-skill.git
cd deepthink-skill

# Copy skill files
cp -r skill/ ~/.claude/skills/deepthink/
cp command/deepthink.md ~/.claude/commands/

# Create data directory
mkdir -p ~/.claude/deepthink-data/{topics,research,sessions}
echo '{"topics":[]}' > ~/.claude/deepthink-data/index.json

Then run /deepthink setup in Claude Code to configure API keys.

---

🔧 Setup Guide

After installing, run /deepthink setup in Claude Code. It will guide you through:

1. Perplexity API Key (Required)

DeepThink uses Perplexity's sonar model for deep research.

1. Go to perplexity.ai/settings/api
2. Create an API key
3. Paste it when /deepthink setup asks

Stored locally at ~/.claude/deepthink-data/.env — never leaves your machine.

2. xurl — X/Twitter CLI (Optional but recommended)

xurl lets DeepThink search X/Twitter for real-time expert opinions.

# macOS
brew install xurl

# Then authenticate
xurl auth login --app deepthink

Without xurl, DeepThink still works — it uses Perplexity + RSS only.

3. RSS Feeds (No setup needed)

DeepThink comes with 11 curated AI-focused RSS sources including:

• Simon Willison's Weblog, Lil'Log (Lilian Weng), Import AI
• Latent Space, One Useful Thing (Ethan Mollick), Every
• Ben's Bites, AINews, Interconnects, Ahead of AI, The Batch

Want to add your own? Edit ~/.claude/skills/deepthink/sources.md.

---

📖 Commands

Command	What it does
/deepthink setup	First-time configuration wizard
/deepthink new: {topic}	Start thinking about a new topic
/deepthink list	See all your active thinking topics
/deepthink research {topic}	Run 3-source deep research
/deepthink read {topic}	View the latest research article
/deepthink chat {topic}	Start a Socratic thinking session
/deepthink continue {topic}	Continue from where you left off
/deepthink summary {topic}	See your full thinking timeline
/deepthink archive {topic}	Archive a completed topic

---

🔄 How It Works

Research (Stage 2)

DeepThink doesn't just Google things. It pulls from three independent source types:

X/Twitter (xurl)          → Real-time expert opinions, debates
Perplexity AI (2 rounds)  → Deep research with citations
RSS (11 curated feeds)    → Long-form analysis from top AI writers

Then synthesizes everything into a research article organized by arguments (not by source), with cross-source validation, contradictions highlighted, and thinking questions derived from gaps in the evidence.

Thinking Sessions (Stage 3)

DeepThink acts as a thinking coach, not a lecturer:

• 🔍 Explores your current position
• 🔬 Deep-dives into vague statements ("what do you mean by 'autonomy'?")
• ⚡ Challenges with counter-evidence from research
• 🔗 Connects scattered ideas into coherent arguments
• 📊 Summarizes your thinking evolution over time

It tracks your belief changes across sessions — so you can see how your thinking evolved.

Session 1: "AI agents will replace most jobs"
Session 3: "AI agents will transform jobs, but human judgment becomes more valuable"
Session 5: "The real question isn't replacement vs augmentation — it's who controls the agents"

---

🧩 Architecture

~/.claude/
├── skills/deepthink/
│   ├── SKILL.md                    # Main skill definition
│   ├── sources.md                  # 11 curated RSS + 9 X/Twitter KOLs
│   └── references/
│       ├── stage1_understanding.md # Topic onboarding flow
│       ├── stage2_research.md      # Research execution manual
│       └── stage3_thinking.md      # Socratic coaching framework
├── commands/
│   └── deepthink.md                # Slash command router
└── deepthink-data/
    ├── .env                        # API keys (local only)
    ├── index.json                  # Topic index
    ├── topics/                     # Topic records
    ├── research/                   # Research articles
    └── sessions/                   # Thinking session logs

---

🌟 Why DeepThink?

Feature	DeepThink	Regular AI Chat
Research depth	3 independent sources, 2-round Perplexity	Single model response
Thinking guidance	Socratic questioning	Gives you the answer
Belief tracking	Records how your views evolve	No memory
Source quality	11 curated expert RSS feeds	Generic web search
Cross-validation	Highlights contradictions between sources	No cross-checking

---

🗺️ Roadmap

• Three-stage workflow (Understand → Research → Think)
• X/Twitter + Perplexity + RSS integration
• Socratic questioning with belief tracking
• Cross-session thinking timeline
• Scheduled research (auto-research on interval)
• Multi-language support
• Custom source libraries (beyond AI)
• Export thinking journal to Markdown/Notion

---

🤝 Contributing

PRs welcome! Areas where help is needed:

• New source libraries — extend beyond AI topics (finance, science, politics)
• Language support — the skill currently works best in Chinese and English
• Thinking frameworks — alternative coaching styles beyond Socratic method

---

📄 License

MIT — see LICENSE

---

Built for humans who refuse to stop thinking.

Star ⭐ this repo if you believe AI should make us think more, not less.