StudyWS

A Claude Code skill suite that transforms any topic into a complete learning package — textbook, interactive study guides, slide descriptions, and podcast prompt.

No application code. Claude Code is the orchestrator. Slash commands are the pipeline stages. Perplexity MCP handles research. Sub-agents handle parallel work.

Install

npm install -g studyws
sws setup

sws setup prompts for your Perplexity API key and configures the MCP server in Claude Code.

Usage

Open Claude Code in any directory and run:

/sws:start

The pipeline flows automatically:

/sws:start     →  Name a topic, set learning preferences
/sws:scope     →  Interactively build a chapter outline
/sws:research  →  Perplexity researches each chapter (parallel)
/sws:write     →  Sub-agents write chapters (parallel)
/sws:diagrams  →  Mermaid diagrams inserted (parallel)
/sws:guide     →  Interactive HTML study guides with quizzes (parallel)
/sws:slides    →  Slide descriptions for deck creation
/sws:podcast   →  Podcast generation prompt

Each command auto-invokes the next. You can also run any command individually to re-run a stage.

Output

All generated content goes to output/{topic-slug}/ in your working directory:

output/kubernetes-networking/
├── config.json              # Topic metadata + learning style
├── outline.json             # Chapter hierarchy
├── research/
│   └── chapter-01.md        # Perplexity research per chapter
├── chapters/
│   └── chapter-01.md        # Written chapters with mermaid diagrams
├── textbook.md              # Full textbook with table of contents
├── guides/
│   └── chapter-01.html      # Interactive study guides (open in browser)
├── slides.md                # Slide descriptions
└── podcast-prompt.md        # Podcast generation prompt

Study Guide Features

Each chapter gets a self-contained HTML study guide with:

• Pre/post quizzes — same questions before and after each section, answers revealed at the end
• Score comparison — see how you improved from pre to post
• Key points — concise bullet summaries per section
• Mermaid diagrams — rendered inline
• Animation scaffolding — placeholder hooks for future interactive visualizations

Open any guides/chapter-*.html directly in your browser. No server needed.

On-Demand Commands

| Command | Description | |---------|-------------| | /sws:review | Opus 4 coherence review of the full textbook | | /sws:status | Show pipeline progress for all topics | | /sws:help | List all commands |

Requirements

• Claude Code with an active subscription
• Node.js 18+
• Perplexity API key (Sonar Pro, ~$0.006/query)

Cost Estimate

Approximately $2-4 per 10-chapter topic (Perplexity research + Claude sub-agents). On-demand Opus 4 review adds ~$2.50.

License

MIT