# LearningOS

> LearningOS (Drona) — an AI Learning Operating System for GitHub Copilot: 129 specialist agents, 510 reusable skills, 122 role configs, and a VS Code extension that teaches instead of just answering.

- **Type:** MCP server
- **Install:** `agentstack add mcp-arasanirohithreddy-learningos`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ArasaniRohithReddy](https://agentstack.voostack.com/s/arasanirohithreddy)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ArasaniRohithReddy](https://github.com/ArasaniRohithReddy)
- **Source:** https://github.com/ArasaniRohithReddy/LearningOS
- **Website:** https://arasanirohithreddy.github.io/LearningOS/

## Install

```sh
agentstack add mcp-arasanirohithreddy-learningos
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# LearningOS — powered by **Drona**

[](https://github.com/ArasaniRohithReddy/LearningOS/releases/latest)
[](LICENSE)
[](https://arasanirohithreddy.github.io/LearningOS/)
[](https://github.com/ArasaniRohithReddy/LearningOS/actions/workflows/validate.yml)
[](https://github.com/ArasaniRohithReddy/LearningOS)
&nbsp;·&nbsp; **129 agents · 779 skills · 122 roles**

> A modular, config-driven **GitHub Copilot Agent framework for learning, teaching, research, and
> technical career growth.** One master orchestrator (**Drona**, the guru), a set of specialist
> sub-agents, and reusable skills — all in the official GitHub Copilot format so they work in
> **VS Code**, **VS Code Insiders**, and the **GitHub Copilot CLI**.

**🌐 Live site:**  &nbsp;·&nbsp;
**⬇ Download:** [latest release](https://github.com/ArasaniRohithReddy/LearningOS/releases/latest) &nbsp;·&nbsp;
**🤝 Contribute:** [open an issue](https://github.com/ArasaniRohithReddy/LearningOS/issues/new/choose) · [start a discussion](https://github.com/ArasaniRohithReddy/LearningOS/discussions) · [CONTRIBUTING.md](CONTRIBUTING.md)

LearningOS is **not** a single chatbot prompt. It is a small platform: agents compose reusable
skills, behavior is shared through a single constitution ([`AGENTS.md`](AGENTS.md)), and new
role-agents are built from tiny YAML config files instead of hand-written prompts.

## Highlights

- **Teaches, not just answers** — first-principles, trade-offs, pitfalls, and a signature *Learning Footer* on every substantive reply ([`AGENTS.md`](AGENTS.md)).
- **129 agents · 779 skills · 122 role configs** — Drona routes to specialist mentors and reusable `/`-skills across every technical domain.
- **Visual-first learning** — Mermaid, tables, KaTeX and step-traces by default, and Drona asks your preferred learning style up front ([`/visual-explainer`](.github/skills/visual-explainer/SKILL.md)).
- **361 no-subscription labs** + run code in **90+ languages** with nothing installed; practice **AWS / Azure / GCP / Oracle** locally via [floci](docs/Floci.md).
- **414 curated free resources** — incl. **275 YouTube channels** — plus dated **tech news** from 190+ RSS/Atom feeds and **130+ roadmap.sh** paths turned into personalized plans ([resources](data/learning-resources.json) · [news](docs/News.md)).
- **Competitive programming & DSA** — LeetCode / Codeforces-style practice: `/competitive-programming-drill`, `/dsa-patterns-coach`, `/dynamic-programming-coach`, `/graph-algorithms-coach`.
- **Own MCP server** ([`mcp/`](mcp/README.md)) — exposes the whole catalog (search skills & agents, resources, roadmaps, news, run code) to Claude Desktop, VS Code and Cursor.
- **Config-driven & multi-host** — VS Code, Insiders, Copilot CLI, Claude, Cursor, Gemini; add a role in YAML with `/role-composer`.

---

## Why this exists

Most "learning agents" are one giant prompt that is hard to extend and inconsistent across tools.
LearningOS instead uses the same primitives GitHub Copilot itself uses:

- **Agents** (`.github/agents/*.agent.md`) — personas with their own tools and responsibilities.
- **Skills** (`.github/skills//SKILL.md`) — on-demand workflows, invocable with `/`.
- **Constitution** (`AGENTS.md`) — shared teaching behavior, auto-loaded everywhere.
- **Role configs** (`.github/roles/*.role.yml`) — compose new specialist agents from config.

Everything optimizes for **teaching**, not just answering. See the teaching principles and the
signature "Learning Footer" in [`AGENTS.md`](AGENTS.md).

## Architecture

```mermaid
flowchart TD
    U([Learner]) --> D{{Drona · Master Orchestrator}}

    D -->|delegates| CM[Coding Mentor]
    D -->|delegates| RN[Research & News Analyst]
    D -->|delegates| IC[Interview Coach]
    D -->|delegates| EC[Exam & Certification Coach]
    D -->|delegates| CA[Career Mentor]
    D -->|delegates| MP[Meeting & Presentation Coach]
    D -->|delegates| RO["122 Role-AgentsSoftware · Languages · Web · Data · AI/ML · Cloud · DevOps · Security · Design · Product · Emerging · Enterprise"]

    subgraph Skills["779 Reusable Skills — invoke with /"]
      S1["Learn · Plan · Practiceconcept-explainer · socratic-tutor · worked-example · analogy-generatorlearning-roadmap · career-ladder · quiz-generator · mock-exam · exam-blueprint"]
      S2["Code & engineeringcode-review-coach · debugging-coach · refactoring-coach · test-writersql-coach · git-coach · dockerfile-coach · regex-explainer · code-optimizer"]
      S3["Architecture & AI/dataarchitecture-diagram · api-design-review · data-modeling-drill · threat-modelprompt-optimizer · rag-designer · eval-designer · dataset-explorer"]
      S4["Research · Writingresearch-brief · daily-digest · official-docs-finder · paper-summarizerreadme-generator · adr-writer · runbook-writer · changelog-writer"]
      S5["Career & communication · Buildresume-tailor · cover-letter · linkedin-optimizer · coding-interview-drillslide-outline · demo-script · role-composer"]
    end

    D -.invokes.-> Skills
    CM -.invokes.-> Skills
    RN -.invokes.-> Skills
    IC -.invokes.-> Skills
    EC -.invokes.-> Skills
    CA -.invokes.-> Skills
    MP -.invokes.-> Skills
    RO -.invokes.-> Skills

    Skills -.reads.-> AG[[AGENTS.md — shared constitution]]
    D -.reads.-> AG
```

## Repository layout

```
Learning Agents/
├── AGENTS.md                      # Shared teaching constitution (auto-loaded everywhere)
├── README.md                      # This file
├── LICENSE                        # MIT
├── CONTRIBUTING.md                # How to add roles / skills / agents / docs
├── CODE_OF_CONDUCT.md
├── docs/                          # The framework "brain" — how & why it works (20 guides)
│   ├── Architecture.md  Agents.md      Skills.md       Roles.md      Standards.md
│   ├── PluginSDK.md     Marketplace.md Extension.md    Install.md    Customize.md
│   ├── CodeExecution.md LocalPractice.md Floci.md      MCP.md        Memory.md
│   ├── News.md          Sources.md     Security.md     Testing.md    Roadmap.md
│   └── mcp.sample.json            # Copy servers into .vscode/mcp.json to enable MCP
├── .github/
│   ├── agents/                    # 129 custom agents (personas)
│   │   ├── drona.agent.md         # ⭐ Master orchestrator
│   │   ├── coding-mentor · research-analyst · interview-coach
│   │   ├── exam-coach · career-mentor · meeting-prep       # 6 core mentors
│   │   └── + 122 role-agents (python/rust/scala-developer, data-engineer, quantum-computing-engineer, …)
│   ├── skills/                    # 779 reusable workflows (slash commands), across 27 groups
│   │   ├── Learn: concept-explainer socratic-tutor misconception-buster analogy-generator worked-example glossary-builder mind-map note-generator teach-back knowledge-graph cheat-sheet
│   │   ├── Plan/Assess: learning-roadmap onboarding-plan career-ladder progress-tracker spaced-repetition-scheduler project-mentor practice-generator quiz-generator flashcards mock-exam skill-assessment gap-analysis rubric-grader exam-blueprint
│   │   ├── Code: code-review-coach debugging-coach refactoring-coach test-writer pair-programmer regex-explainer sql-coach git-coach dockerfile-coach code-optimizer algorithm-visualizer complexity-analyzer code-walkthrough system-design-drill
│   │   ├── Architecture/AI-data: architecture-diagram api-design-review data-modeling-drill threat-model tech-comparison estimation-coach prompt-optimizer rag-designer eval-designer dataset-explorer
│   │   ├── Research/Writing: research-brief daily-digest feed-curator official-docs-finder engineering-blog-finder github-repo-finder paper-summarizer literature-review technical-writing-coach readme-generator adr-writer runbook-writer documentation-planner changelog-writer
│   │   └── Career/Build: resume-tailor cover-letter linkedin-optimizer salary-negotiation star-story-builder portfolio-reviewer coding-interview-drill whiteboard-explainer slide-outline demo-script case-study role-composer
│   └── roles/                     # 122 config-driven role definitions — add your own!
│       ├── _TEMPLATE.role.yml
│       ├── Software · Languages (Py/Java/C#/Go/Rust/C++/TS/Kotlin/Scala/PHP/Swift/Elixir/R/Dart/Haskell/Clojure) · Web
│       ├── AI/ML · MLOps · Deep Learning · LLMOps · CV · NLP
│       ├── Data & BI · Streaming · Big Data · Snowflake · Tableau · Looker · Governance
│       ├── Cloud (Azure/AWS/GCP) · Platform · Network · Terraform · Serverless
│       ├── DevOps · SRE · Observability · FinOps · Linux/Windows admin · Chaos · Perf
│       ├── Security (App/Cloud/SOC/DevSecOps/IAM/GRC/Privacy) · QA/SDET · Architecture
│       ├── Emerging (AR/VR · Quantum · Edge · Graphics · Bioinformatics · Quant · GIS · HPC)
│       └── Design · Docs · DevRel · Product · EM · TPM · BA · Scrum · Business/Support · Enterprise (SF/ServiceNow/SAP/D365)
├── data/                          # Curated catalogs: 193 news feeds, 134 roadmaps, 414 free learning resources
├── mcp/                           # LearningOS MCP server (learningos-mcp) — 9 tools · 2 resources · 3 prompts
├── extension/                     # VS Code extension (@drona + dashboard + Tech News / Roadmaps views)
├── templates/                     # Optional MCP config templates (e.g., floci.mcp.json)
├── marketplace/                   # Generated pack index (registry.json + CATALOG.md)
├── scripts/build-registry.mjs     # Scans agents/skills/roles → rebuilds the marketplace index
```

## Documentation

The [`docs/`](docs/) folder is the framework's brain — how and why it works:

| Doc | Topic |
|---|---|
| [Architecture](docs/Architecture.md) | The five primitives, request flow, design principles |
| [Agents](docs/Agents.md) | Persona roster + how the "100+ agents" vision is served |
| [Skills](docs/Skills.md) | Skill catalog, authoring, and progressive loading |
| [Roles](docs/Roles.md) | The config-driven role system + full 122-role catalog |
| [PluginSDK](docs/PluginSDK.md) | Packaging & distribution model |
| [Install](docs/Install.md) | Install across every host (Copilot CLI, VS Code/Insiders, Desktop, Claude, Cursor, Gemini) + one-command `install.ps1` |
| [Platforms](docs/Platforms.md) | **Individual-level** cross-platform setup (Claude Code/Desktop, Cursor, Gemini, M365 Cowork) — zip import, per-host MCP wiring, **opt-in** Azure CLI auth |
| [Extension](docs/Extension.md) | Drona as an installable **`.vsix`** (`@drona` chat participant) — no Marketplace account needed |
| [CodeExecution](docs/CodeExecution.md) | Run code in 90+ languages with **no local install** (self-hosted Piston / onlinecompiler.io key) — setup + where to get a key |
| [Customize](docs/Customize.md) | Add / edit / disable your own skills & agents; scaffolders + `validate.mjs` |
| [Marketplace](docs/Marketplace.md) | Enterprise plugin marketplace: pack model + generated registry |
| [LocalPractice](docs/LocalPractice.md) | Practice every domain locally & free (no subscriptions) — the tool catalog |
| [Floci — local cloud](docs/Floci.md) | Practice **AWS, Azure, GCP & Oracle (OCI)** locally & free with floci emulators — install, per-cloud endpoints, and the honest "AI-ready"/MCP story |
| [MCP](docs/MCP.md) | Live docs/data via MCP + **LearningOS's own MCP server** ([`mcp/`](mcp/README.md)) for any client (Claude/VS Code/Cursor) + [sample config](docs/mcp.sample.json) |
| [Memory](docs/Memory.md) | Learner profile, spaced repetition, RAG |
| [News](docs/News.md) | News / RSS / research framework |
| [Standards](docs/Standards.md) | Coding & teaching standards |
| [Security](docs/Security.md) | Security & Responsible AI guardrails |
| [Testing](docs/Testing.md) | Structural + behavioral evaluation |
| [Roadmap](docs/Roadmap.md) | Vision → status and what's next |

## Install & use

LearningOS is discovered automatically when this folder is your workspace/repo root. Nothing to build.

### VS Code / VS Code Insiders (Agent Mode)

1. Open this folder in VS Code or VS Code Insiders (Copilot Chat + Agent Mode enabled).
2. In the Chat view, open the **agent picker** and choose **Drona** (or any specialist).
3. Ask naturally — e.g. *"Teach me how Kubernetes scheduling works and quiz me."*
4. Invoke a skill directly by typing `/` and picking one, e.g. `/learning-roadmap`, `/quiz-generator`.

> Skill discovery locations are already enabled in `.vscode/settings.json` via
> `chat.agentSkillsLocations` (`.github/skills` is included). Skills under `.github/skills/` and
> agents under `.github/agents/` are picked up with no extra setup.

### GitHub Copilot CLI

1. Install the CLI and sign in (`copilot`), then `cd` into this folder.
2. `AGENTS.md` is loaded automatically as shared guidance.
3. Custom agents in `.github/agents/` and skills in `.github/skills/` are available in the session.
4. Ask Drona to teach, plan, quiz, or research — the same behavior as in VS Code.

### Use it in another project

Copy `AGENTS.md` and the `.github/agents/`, `.github/skills/`, and `.github/roles/` folders (and
optionally `docs/`) into any repository. That repo instantly gains the full LearningOS toolkit.

## Quick start prompts

- `@Drona teach me the CAP theorem from first principles, then give me 5 quiz questions.`
- `/learning-roadmap 90-day plan to become an Azure AI Engineer, ~1 hour/day`
- `/research-brief latest changes in the Model Context Protocol (MCP) spec, official sources only`
- `@Interview Coach run a 30-minute system design mock for a URL shortener and score me`
- `/code-review-coach review this function and teach me what to improve`
- `/flashcards 20 spaced-repetition cards on Kubernetes networking`

## Practice cloud & tech locally (no subscription needed)

LearningOS includes **361 hands-on labs** (`*-lab` skills) so you learn by doing — per language
(Python, JS, TS, Go, Rust, Java, C#), framework (React), data (pandas, SQL, Spark, Kafka, PyTorch),
and tooling (Git, Docker/Kubernetes).

For **AWS / Azure / GCP / Oracle (OCI)**, you can do the cloud labs **entirely offline** against the
free, open-source **[Floci](https://github.com/floci-io/floci)** local emulators — `docker compose up`,
no cloud account, token, or paid tier. The dedicated skills walk you through setup:

- `/floci-aws-local-lab` — AWS locally via [Floci](https://github.com/floci-io/floci) (`http://localhost:4566`)
- `/floci-azure-local-lab` — Azure locally via [Floci AZ](https://github.com/floci-io/floci-az) (`http://localhost:4577`)
- `/floci-gcp-local-lab` — GCP locally via [floci-gcp](https://github.com/floci-io/floci-gcp) (`http://localhost:4588`)
- `/floci-oracle-local-lab` — Oracle (OCI) locally via [floci-oci](https://github.com/floci-io/floci-oci) (`http://localhost:4599`)

Point your existing SDK / CLI / Terraform at the local endpoint and run the `aws-*-lab`, `azure-*-lab`,
and `gcp-*-lab` exercises for free. (Floci is an emulator for learning/dev/testing — verify behavior
against the official cloud docs before production.)

**And it's not just cloud** — you can practice **databases** (Postgres, MySQL, MongoDB, Redis, SQLite),
**messaging** (Redpanda/Kafka, RabbitMQ, NATS, MQTT), **Kubernetes** (minikube, kind, k3d),
**observability** (Prometheus + Grafana, Jaeger), **auth** (Keycloak), and even **LLMs & RAG** (Ollama +
Chroma/Qdrant/pgvector — *no API key or cost*) entirely on your laptop. The full, verified catalog with
the matching labs is in **[docs/LocalPractice.md](docs/LocalPractice.md)**.

## Extend it — build a new role-agent from config

Instead of writing a new prompt, describe the role in YAML and let LearningOS build the agent:

1. Copy `.github/roles/_TEMPLATE.role.yml` to `.github/roles/my-role.role.yml` and fill it in.
2. Run the `role-composer` skill: `/role-composer .github/roles/my-role.role.yml`.
3. A ready-to-use `.github/agents/.agent.md` is generated in the correct format.

**122 ready-made role configs** ship across every domain (Software, Programming Languages, Web &
Frameworks, AI/ML, Data/BI, Cloud & Platform, DevOps/SRE, Security, QA & Testing, Design/Docs,
Archite

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ArasaniRohithReddy](https://github.com/ArasaniRohithReddy)
- **Source:** [ArasaniRohithReddy/LearningOS](https://github.com/ArasaniRohithReddy/LearningOS)
- **License:** MIT
- **Homepage:** https://arasanirohithreddy.github.io/LearningOS/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-arasanirohithreddy-learningos
- Seller: https://agentstack.voostack.com/s/arasanirohithreddy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
