|
| 1 | +# Noob Mode Plugin |
| 2 | + |
| 3 | +Plain-English translation layer for non-technical Copilot CLI users. When activated, Copilot automatically translates every permission request, error message, and technical output into clear, jargon-free language with color-coded risk indicators. |
| 4 | + |
| 5 | +## Who Is This For? |
| 6 | + |
| 7 | +Anyone who uses Copilot CLI but **isn't** a software developer: |
| 8 | +- Lawyers and legal professionals |
| 9 | +- Product managers and program managers |
| 10 | +- Business stakeholders and executives |
| 11 | +- Technical writers and content creators |
| 12 | +- Designers who work with code-adjacent tools |
| 13 | +- Anyone who's new to the command line |
| 14 | + |
| 15 | +## Installation |
| 16 | + |
| 17 | +```bash |
| 18 | +copilot plugin install noob-mode@awesome-copilot |
| 19 | +``` |
| 20 | + |
| 21 | +## What's Included |
| 22 | + |
| 23 | +### Commands (Slash Commands) |
| 24 | + |
| 25 | +| Command | Description | |
| 26 | +|---------|-------------| |
| 27 | +| `/noob-mode:noob-mode` | Activate Noob Mode for the current session. Copilot will explain everything in plain English — every action, every permission request, and every result. | |
| 28 | + |
| 29 | +### Bundled Assets |
| 30 | + |
| 31 | +| Asset | Description | |
| 32 | +|-------|-------------| |
| 33 | +| `references/glossary.md` | 100+ technical terms defined in plain English, organized by category (Git, File System, Development, Web, Copilot CLI) | |
| 34 | +| `references/examples.md` | 15 before/after examples showing how Noob Mode transforms technical output into clear explanations | |
| 35 | + |
| 36 | +## Features |
| 37 | + |
| 38 | +| Feature | What it means for you | |
| 39 | +|---|---| |
| 40 | +| **Approval Translation** | Every time Copilot asks permission, it explains WHAT it wants to do, WHY, how RISKY it is, and what happens if you say yes or no | |
| 41 | +| **Risk Indicators** | Color-coded risk levels (🟢 Low, 🟡 Moderate, 🔴 High, ⛔ Critical) so you can instantly see if an action is safe | |
| 42 | +| **Jargon Detection** | Technical terms are automatically defined in plain English the first time they appear | |
| 43 | +| **Step-by-Step Plans** | Multi-step tasks start with a plain-English roadmap so you know what's coming | |
| 44 | +| **Output Translation** | Error messages and command results are translated into "here's what that means" | |
| 45 | +| **Completion Summaries** | After every task, you get a summary of what changed, what was created, and how to undo it | |
| 46 | +| **Decision Support** | When you need to choose between options, each one is explained with trade-offs and a recommendation | |
| 47 | + |
| 48 | +## Example |
| 49 | + |
| 50 | +**Without Noob Mode:** |
| 51 | +``` |
| 52 | +Allow tool: bash with command "grep -r 'indemnification' ./contracts/"? |
| 53 | +[y/n] |
| 54 | +``` |
| 55 | + |
| 56 | +**With Noob Mode:** |
| 57 | +``` |
| 58 | +📋 WHAT I'M ASKING TO DO: |
| 59 | +I want to search all files in your "contracts" folder for the word "indemnification." |
| 60 | +
|
| 61 | +🎯 WHY: |
| 62 | +You asked me to find every mention of indemnification across your contracts. |
| 63 | +
|
| 64 | +⚠️ RISK: 🔴 High (but safe in this case) |
| 65 | +Running commands is generally high-risk, but this one only searches — it doesn't |
| 66 | +change or delete anything. |
| 67 | +
|
| 68 | +✅ If you approve: I'll show you every file where "indemnification" appears. |
| 69 | +❌ If you decline: I can read files one by one instead, but it'll take longer. |
| 70 | +``` |
| 71 | + |
| 72 | +## How to Turn Off |
| 73 | + |
| 74 | +Say "turn off noob mode" in your conversation, and Copilot will return to its default communication style. |
| 75 | + |
| 76 | +## Source |
| 77 | + |
| 78 | +This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions. |
| 79 | + |
| 80 | +## License |
| 81 | + |
| 82 | +MIT |
0 commit comments