Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (studyws) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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