CodeCoach
Interactive coding tutor for GitHub Copilot — adaptive quizzes, automatic snapshots, and tool discovery.

Skills
| Skill |
Command |
Purpose |
| codecoach-modes |
/codecoach-modes |
Lists all CodeCoach tools and capabilities |
| codecoach-snapshot |
/codecoach-snapshot on\|off\|status |
Toggle automatic pre-edit file snapshots |
| codecoach-teach |
teach me, quiz me |
Interactive code quiz with 4 themes × 5 levels |
Quick Start
# Install from VS Code Marketplace (when published)
# Or install locally:
git clone https://github.com/throthe/codecoach-plugin
cd codecoach-copilot-plugin
npm install
npm run package
code --install-extension codecoach-1.0.0.vsix
In VS Code: Open Copilot Chat and type:
/codecoach-modes — See all available tools
/codecoach-snapshot on — Enable auto-snapshots before edits
teach me — Start an adaptive code quiz (level 3 default)
CodeCoach Teach — Quiz Themes
| Theme |
Focus |
Best For |
| Standard Reconstruction |
Line removal/restoration |
Logic comprehension |
| SOLID Anti-Patterns |
Design pattern fixes |
Architecture skills |
| Spec-to-Code Traceability |
Requirements → code mapping |
Documentation discipline |
| Logic Paths Execution |
Control flow tracing |
Debugging intuition |
Modifiers: teach me level 2, teach me decorators, teach me solid interactive, teach me logic-paths l4
For Developers — Build & Publish
Prerequisites
- Node.js 18+
vsce (npm install -g @vscode/vsce)
- VS Code for testing
Project Structure
codecoach-copilot-plugin/
├── package.json # VS Code extension manifest
├── tsconfig.json # TypeScript config
├── .eslintrc.json # ESLint config
├── .vscodeignore # Package exclusions
├── CHANGELOG.md # Version history
├── LICENSE # GPL-3.0
├── icon.png # 128x128 extension icon
├── src/
│ └── extension.ts # Entry point (minimal)
├── extension/out/ # Compiled JS (generated)
└── codecoach-plugin/ # Agent Plugins 1.0 skills
├── plugin.json # Agent Plugins manifest
└── skills/ # Three Copilot skills
Scripts
| Command |
Description |
npm run compile |
Compile TypeScript |
npm run watch |
Watch mode for development |
npm run lint |
Run ESLint |
npm run validate:all |
All markdown checks |
npm run package |
Create .vsix |
npm run publish |
Publish to Marketplace |
Publishing Checklist
- Create publisher at Marketplace
vsce login <publisher-name> (with PAT)
- Replace
icon.png with real 128×128 PNG
- Update
publisher in package.json
npm version patch|minor|major
npm run publish
Testing
# Local install test
npm run package
code --install-extension codecoach-1.0.0.vsix
# Dev mode (F5 in VS Code)
# Opens Extension Development Host
Architecture
Zero runtime code — Skills are purely declarative:
- Defined in
codecoach-plugin/skills/*/SKILL.md (Markdown instructions)
- Registered via
contributes.copilotSkills in package.json
- Auto-discovered by GitHub Copilot at runtime
- Works in VS Code, Copilot CLI, GitHub Codespaces
License
GPL-3.0 — Free software, copyleft. See LICENSE.
Resources