expert-mentor 0.6.2__tar.gz

expert_mentor-0.6.2/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    name: test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run self-test suite
+        run: python scripts/selftest.py
+
+      - name: Health check
+        run: python scripts/expert_mentor.py doctor
+
+      - name: Generate a sample prompt
+        run: python scripts/expert_mentor.py --field "quantum computing" --level beginner > /dev/null
+
+  package:
+    name: build & install
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install the package
+        run: pip install .
+      - name: Verify console entry point
+        run: mentor version
+      - name: Verify bundled resources resolve after install
+        run: mentor fields

expert_mentor-0.6.2/.github/workflows/release.yml

@@ -0,0 +1,77 @@
+name: Release
+
+# Publishes to PyPI using Trusted Publishing (OIDC) — no API token stored.
+#
+# One-time setup on PyPI:
+#   https://pypi.org/manage/account/publishing/
+#   Add a "pending publisher" with:
+#     PyPI project name: expert-mentor
+#     Owner:             <your GitHub username or org>
+#     Repository name:   <this repo>
+#     Workflow name:     release.yml
+#     Environment name:  pypi
+#
+# Then publish by pushing a tag:  git tag v0.5.0 && git push origin v0.5.0
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Check the distributions
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/expert-mentor
+    permissions:
+      id-token: write   # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "${GITHUB_REF_NAME}" dist/* --generate-notes

expert_mentor-0.6.2/CHANGELOG.md

@@ -0,0 +1,72 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.6.2] - 2026-10-31
+
+### Added
+- Live sessions for Google/Gemini (`mentor run --provider google`), on par with
+  Anthropic, OpenAI, Ollama, and llama.cpp.
+- `mentor skill` — install the Claude Code / opencode skill from the CLI
+  itself, so a `pip`/`pipx` install gets it too, not just a git checkout.
+- `examples/cpp.google.transcript.md` — a live Gemini tutoring transcript.
+
+### Fixed
+- `google`'s default model was the retired `gemini-2.5-pro`; now the rolling
+  `gemini-flash-latest` alias.
+
+### Changed
+- `install.sh` now calls `mentor skill` instead of duplicating its symlink logic.
+
+## [0.6.1] - 2026-09-12
+
+### Changed
+- Package the README as the PyPI long description and ship `docs/` in the sdist.
+- Add a `MANIFEST.in` so documentation is included in source distributions.
+
+## [0.6.0] - 2026-09-12
+
+### Added
+- Spaced-repetition flashcards: `mentor cards` (add / generate / list / remove)
+  and `mentor quiz` with an SM-2-lite scheduler (`scripts/mentor_cards.py`,
+  `templates/cards_prompt.md`).
+- `mentor run --history-turns N` caps how many past turns are kept in context.
+
+### Fixed
+- Include `mentor_cards` in the packaged modules so the installed wheel runs.
+
+## [0.5.0] - 2026-09-12
+
+### Added
+- Persistent learner memory and session transcripts (`mentor learners`,
+  `mentor progress`, `mentor sessions`, `mentor transcript`).
+- Model-assisted progress review: `mentor review [--apply]`.
+- Packaging (`pyproject.toml`, console entry points), CI, and a
+  Trusted-Publishing release workflow.
+- Config file: `mentor config`.
+- Colored, TTY-aware health output and `--quiet`.
+
+### Changed
+- Provider-native handling for Claude (prompt caching, extended thinking, XML
+  shaping) and ChatGPT (developer role, `max_completion_tokens`,
+  `reasoning_effort`, usage reporting).
+- Live sessions for Anthropic, OpenAI, Ollama, and llama.cpp with retry/backoff.
+- Model catalog and live discovery: `mentor models --refresh`.
+
+## [0.1.0] - 2026-09-11
+
+### Added
+- Initial release: provider-aware expert-mentor prompt generation, curated field
+  profiles, curriculum and compact templates, one-command installer, and the
+  `SKILL.md` agent skill.
+
+[Unreleased]: https://github.com/voidstackloop/expert-mentor/compare/v0.6.2...HEAD
+[0.6.2]: https://github.com/voidstackloop/expert-mentor/compare/v0.6.1...v0.6.2
+[0.6.1]: https://github.com/voidstackloop/expert-mentor/compare/v0.6.0...v0.6.1
+[0.6.0]: https://github.com/voidstackloop/expert-mentor/releases/tag/v0.6.0
+[0.5.0]: https://github.com/voidstackloop/expert-mentor/releases
+[0.1.0]: https://github.com/voidstackloop/expert-mentor/releases

expert_mentor-0.6.2/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing
+
+Thanks for helping improve expert-mentor. This project is intentionally small,
+dependency-free, and easy to run locally.
+
+## Setup
+
+```bash
+git clone https://github.com/voidstackloop/expert-mentor
+cd expert-mentor
+./install.sh          # or run in place with ./bin/mentor
+make doctor
+```
+
+## Before you open a PR
+
+```bash
+make test             # 99+ assertions, no third-party deps
+```
+
+- Add a test for any non-trivial change (see `scripts/selftest.py`).
+- Keep the code **standard library only** at runtime.
+- Follow the existing style; `ruff` config is in `pyproject.toml` (line length 120).
+- Update `README.md` / `docs/` when behaviour changes, and add a `CHANGELOG.md`
+  entry under `Unreleased`.
+
+## Good first contributions
+
+- **Add a field profile** — see `references/fields.md`; append to
+  `references/fields.json`.
+- **Add a provider adapter** — streaming backends live in
+  `scripts/mentor_runtime.py`; payload builders are pure and unit-tested.
+- **Improve a prompt** — `templates/*.md`.
+- **Fix an example** — `examples/` is regenerated from the CLI.
+
+## Commit messages
+
+Use a short imperative subject and explain the *why* in the body. Reference an
+issue if there is one.
+
+## Pull requests
+
+1. Fork and branch from `main`.
+2. Make the change with tests.
+3. Ensure `make test` passes and CI is green.
+4. Open the PR with a clear description of the change and its motivation.
+
+## Reporting issues
+
+Include your OS, Python version (`mentor version`), the exact command, and the
+full output. `mentor doctor` output is helpful too.

expert_mentor-0.6.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 expert-mentor contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

expert_mentor-0.6.2/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md
+include CHANGELOG.md
+include CONTRIBUTING.md
+include LICENSE
+include SKILL.md
+include Makefile
+recursive-include docs *.md
+recursive-include templates *.md
+recursive-include references *.md *.json
+recursive-include examples *
+recursive-include bin *
+recursive-include .github *.yml

expert_mentor-0.6.2/Makefile

@@ -0,0 +1,59 @@
+PYTHON ?= python3
+
+.PHONY: help install uninstall test demo curriculum fields providers doctor dist skill-zip bundles clean
+
+help:
+	@echo "expert-mentor"
+	@echo ""
+	@echo "  make install      install the 'mentor' command and link the skill"
+	@echo "  make uninstall    remove the command and skill links"
+	@echo "  make test         run the self-test suite"
+	@echo "  make doctor       check the local setup"
+	@echo "  make fields       list curated field profiles"
+	@echo "  make providers    list supported providers"
+	@echo "  make demo         generate a sample prompt to stdout"
+	@echo "  make curriculum   generate a sample curriculum prompt to stdout"
+	@echo "  make dist         build sdist + wheel into dist/ (needs 'build')"
+	@echo "  make skill-zip    package SKILL.md + supporting files for marketplace submission"
+	@echo "  make bundles      build all provider bundles into bundles/"
+	@echo "  make clean        remove __pycache__ and build artifacts"
+
+install:
+	@chmod +x install.sh uninstall.sh bin/mentor scripts/*.py
+	@./install.sh
+
+uninstall:
+	@chmod +x uninstall.sh
+	@./uninstall.sh
+
+test:
+	@$(PYTHON) scripts/selftest.py
+
+doctor:
+	@$(PYTHON) scripts/expert_mentor.py doctor
+
+fields:
+	@$(PYTHON) scripts/expert_mentor.py --list-fields
+
+providers:
+	@$(PYTHON) scripts/expert_mentor.py --list-providers
+
+demo:
+	@$(PYTHON) scripts/expert_mentor.py --field "quantum computing" --level beginner
+
+curriculum:
+	@$(PYTHON) scripts/expert_mentor.py curriculum --field "Rust" --level intermediate
+
+dist:
+	@$(PYTHON) -m pip install --quiet --upgrade build
+	@$(PYTHON) -m build
+	@echo "artifacts in dist/ — publish with: python -m twine upload dist/*"
+
+skill-zip:
+	@$(PYTHON) scripts/build_skill_zip.py
+
+bundles:
+	@$(PYTHON) scripts/build_bundles.py
+
+clean:
+	@rm -rf scripts/__pycache__ build dist *.egg-info scripts/*.egg-info

expert_mentor-0.6.2/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: expert-mentor
+Version: 0.6.2
+Summary: Turn any LLM (Claude, ChatGPT, Gemini, Ollama, llama.cpp) into a professional teacher for any field.
+Author: expert-mentor contributors
+License: MIT
+Project-URL: Homepage, https://github.com/voidstackloop/expert-mentor
+Project-URL: Repository, https://github.com/voidstackloop/expert-mentor
+Project-URL: Issues, https://github.com/voidstackloop/expert-mentor/issues
+Project-URL: Changelog, https://github.com/voidstackloop/expert-mentor/releases
+Project-URL: PyPI, https://pypi.org/project/expert-mentor/
+Keywords: llm,mentor,tutor,education,claude,chatgpt,ollama,prompt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# expert-mentor
+
+**Turn any LLM — Claude, ChatGPT, Gemini, or a local Ollama / llama.cpp model — into a professional teacher for any field.**
+
+`expert-mentor` generates a calibrated expert-mentor system prompt for a field and
+level, runs the tutoring session directly, remembers what you've mastered across
+sessions, and reviews your progress from the transcript.
+
+![Generating a Rust mentor prompt](docs/images/terminal-prompt-rust.png)
+
+<details>
+<summary>More screenshots and diagrams</summary>
+
+![How a field becomes a mentor session](docs/images/diagram-flow.svg)
+![Curated field profiles](docs/images/terminal-fields.png)
+![Supported providers](docs/images/terminal-providers.png)
+![mentor doctor](docs/images/terminal-doctor.png)
+
+More in [docs/diagrams.md](docs/diagrams.md).
+</details>
+
+MIT licensed · Python 3.8+ · zero runtime dependencies
+
+---
+
+## Why
+
+Most "tutor" prompts are a persona and a vibe. This one is a system: a teaching
+contract grounded in learning science (retrieval practice, spacing,
+scaffolding), provider-native request handling, and a persistent learner model.
+The mentor teaches to the standard a real senior practitioner would recognise —
+one concept at a time, checking understanding, and never fabricating sources.
+
+## Highlights
+
+- **Provider-native prompts** — XML-shaped, prompt-cached system blocks for
+  Claude; `developer` role, `max_completion_tokens`, and `reasoning_effort` for
+  ChatGPT reasoning models; correct handling for Gemini, Ollama, and llama.cpp.
+- **Live tutoring sessions** over Anthropic, OpenAI, Ollama, and llama.cpp —
+  standard library only, no runtime dependencies.
+- **Persistent learner memory** — mastered / shaky / misconceptions / open
+  questions, injected into every future session.
+- **Model-assisted review** — turn a session transcript into an updated profile.
+- **Spaced repetition** — generate flashcards from a session and review them with
+  an SM-2-lite scheduler (`mentor cards` / `mentor quiz`).
+- **Curriculum design** — a structured, sequenced multi-week plan for any field.
+- **Usable as an agent skill** — ships with `SKILL.md` for Claude Code / opencode.
+
+## Install
+
+No install needed — run it in place from this folder:
+
+```bash
+python3 scripts/expert_mentor.py --field "quantum computing" --level beginner
+```
+
+Want a `mentor` command on your PATH and the skill linked into Claude Code /
+opencode? Run the installer once from inside this folder:
+
+```bash
+./install.sh
+```
+
+## Quick start
+
+```bash
+# Generate a system prompt for a field
+mentor --field "quantum computing" --level beginner
+
+# Run a live tutoring session (local model)
+mentor run --field "Rust" --provider ollama --model qwen2.5:7b
+
+# Run with Claude, remembering progress between sessions
+mentor run --field "Rust" --provider claude --remember
+
+# Build a curriculum
+mentor curriculum --field "Rust" --duration "6 weeks, 5h/week"
+```
+
+## Live sessions
+
+```bash
+# Claude — system prompt is cached and XML-shaped; optional extended thinking
+mentor run --field "contract law" --provider claude --model claude-sonnet-5 --thinking
+
+# ChatGPT — reasoning effort, developer role, usage reported per turn
+mentor run --field "Rust" --provider chatgpt --model gpt-5.6 --reasoning-effort high
+
+# Local — Ollama or a llama.cpp / LM Studio server
+mentor run --field "music theory" --provider ollama --host http://localhost:11434
+```
+
+Credentials come from the environment or a `.env` file
+(`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`). See
+[docs/providers.md](docs/providers.md).
+
+## Remembering a learner
+
+```bash
+# Persist progress automatically (named from the field)
+mentor run --field "Rust" --provider claude --remember
+
+# Inspect or curate the profile
+mentor learners
+mentor progress rust --add-mastered ownership --add-shaky lifetimes --goal "ship idiomatic Rust"
+
+# Assess the last session and update the profile
+mentor review rust --apply
+
+# Turn the session into flashcards and review them over time
+mentor cards rust --generate
+mentor quiz rust
+```
+
+Profiles, transcripts, prompts, and cards live under
+`~/.config/expert-mentor/` as plain JSON/markdown you can read and edit.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `mentor --field F [...]` | generate a teaching prompt |
+| `mentor run [NAME]` | live tutoring session (cloud or local) |
+| `mentor save/show/saved` | store and reuse mentor prompts |
+| `mentor curriculum` | sequenced multi-week curriculum prompt |
+| `mentor models` | list / discover Claude & ChatGPT models |
+| `mentor fields` / `providers` | curated field profiles / providers |
+| `mentor learners` / `progress` / `sessions` / `transcript` / `review` | learner memory & assessment |
+| `mentor cards` / `quiz` | spaced-repetition flashcards |
+| `mentor config` | saved defaults |
+| `mentor doctor` | health check |
+| `mentor skill` | install the Claude Code / opencode skill |
+| `mentor interactive` | build a profile by answering prompts |
+
+Full reference: [docs/commands.md](docs/commands.md).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md)
+- [Command reference](docs/commands.md)
+- [Providers & credentials](docs/providers.md)
+- [How the mentor teaches](docs/learning.md)
+- [Configuration](docs/configuration.md)
+- [Using it as an agent skill](docs/skill.md)
+- [Development](docs/development.md)
+
+## Requirements
+
+Python 3.8+. No third-party runtime dependencies. A local [Ollama](https://ollama.com)
+or llama.cpp server is optional (for offline use).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Run `make test` before opening a PR.
+
+## License
+
+[MIT](LICENSE) © expert-mentor contributors.

expert_mentor-0.6.2/README.md

@@ -0,0 +1,158 @@
+# expert-mentor
+
+**Turn any LLM — Claude, ChatGPT, Gemini, or a local Ollama / llama.cpp model — into a professional teacher for any field.**
+
+`expert-mentor` generates a calibrated expert-mentor system prompt for a field and
+level, runs the tutoring session directly, remembers what you've mastered across
+sessions, and reviews your progress from the transcript.
+
+![Generating a Rust mentor prompt](docs/images/terminal-prompt-rust.png)
+
+<details>
+<summary>More screenshots and diagrams</summary>
+
+![How a field becomes a mentor session](docs/images/diagram-flow.svg)
+![Curated field profiles](docs/images/terminal-fields.png)
+![Supported providers](docs/images/terminal-providers.png)
+![mentor doctor](docs/images/terminal-doctor.png)
+
+More in [docs/diagrams.md](docs/diagrams.md).
+</details>
+
+MIT licensed · Python 3.8+ · zero runtime dependencies
+
+---
+
+## Why
+
+Most "tutor" prompts are a persona and a vibe. This one is a system: a teaching
+contract grounded in learning science (retrieval practice, spacing,
+scaffolding), provider-native request handling, and a persistent learner model.
+The mentor teaches to the standard a real senior practitioner would recognise —
+one concept at a time, checking understanding, and never fabricating sources.
+
+## Highlights
+
+- **Provider-native prompts** — XML-shaped, prompt-cached system blocks for
+  Claude; `developer` role, `max_completion_tokens`, and `reasoning_effort` for
+  ChatGPT reasoning models; correct handling for Gemini, Ollama, and llama.cpp.
+- **Live tutoring sessions** over Anthropic, OpenAI, Ollama, and llama.cpp —
+  standard library only, no runtime dependencies.
+- **Persistent learner memory** — mastered / shaky / misconceptions / open
+  questions, injected into every future session.
+- **Model-assisted review** — turn a session transcript into an updated profile.
+- **Spaced repetition** — generate flashcards from a session and review them with
+  an SM-2-lite scheduler (`mentor cards` / `mentor quiz`).
+- **Curriculum design** — a structured, sequenced multi-week plan for any field.
+- **Usable as an agent skill** — ships with `SKILL.md` for Claude Code / opencode.
+
+## Install
+
+No install needed — run it in place from this folder:
+
+```bash
+python3 scripts/expert_mentor.py --field "quantum computing" --level beginner
+```
+
+Want a `mentor` command on your PATH and the skill linked into Claude Code /
+opencode? Run the installer once from inside this folder:
+
+```bash
+./install.sh
+```
+
+## Quick start
+
+```bash
+# Generate a system prompt for a field
+mentor --field "quantum computing" --level beginner
+
+# Run a live tutoring session (local model)
+mentor run --field "Rust" --provider ollama --model qwen2.5:7b
+
+# Run with Claude, remembering progress between sessions
+mentor run --field "Rust" --provider claude --remember
+
+# Build a curriculum
+mentor curriculum --field "Rust" --duration "6 weeks, 5h/week"
+```
+
+## Live sessions
+
+```bash
+# Claude — system prompt is cached and XML-shaped; optional extended thinking
+mentor run --field "contract law" --provider claude --model claude-sonnet-5 --thinking
+
+# ChatGPT — reasoning effort, developer role, usage reported per turn
+mentor run --field "Rust" --provider chatgpt --model gpt-5.6 --reasoning-effort high
+
+# Local — Ollama or a llama.cpp / LM Studio server
+mentor run --field "music theory" --provider ollama --host http://localhost:11434
+```
+
+Credentials come from the environment or a `.env` file
+(`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`). See
+[docs/providers.md](docs/providers.md).
+
+## Remembering a learner
+
+```bash
+# Persist progress automatically (named from the field)
+mentor run --field "Rust" --provider claude --remember
+
+# Inspect or curate the profile
+mentor learners
+mentor progress rust --add-mastered ownership --add-shaky lifetimes --goal "ship idiomatic Rust"
+
+# Assess the last session and update the profile
+mentor review rust --apply
+
+# Turn the session into flashcards and review them over time
+mentor cards rust --generate
+mentor quiz rust
+```
+
+Profiles, transcripts, prompts, and cards live under
+`~/.config/expert-mentor/` as plain JSON/markdown you can read and edit.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `mentor --field F [...]` | generate a teaching prompt |
+| `mentor run [NAME]` | live tutoring session (cloud or local) |
+| `mentor save/show/saved` | store and reuse mentor prompts |
+| `mentor curriculum` | sequenced multi-week curriculum prompt |
+| `mentor models` | list / discover Claude & ChatGPT models |
+| `mentor fields` / `providers` | curated field profiles / providers |
+| `mentor learners` / `progress` / `sessions` / `transcript` / `review` | learner memory & assessment |
+| `mentor cards` / `quiz` | spaced-repetition flashcards |
+| `mentor config` | saved defaults |
+| `mentor doctor` | health check |
+| `mentor skill` | install the Claude Code / opencode skill |
+| `mentor interactive` | build a profile by answering prompts |
+
+Full reference: [docs/commands.md](docs/commands.md).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md)
+- [Command reference](docs/commands.md)
+- [Providers & credentials](docs/providers.md)
+- [How the mentor teaches](docs/learning.md)
+- [Configuration](docs/configuration.md)
+- [Using it as an agent skill](docs/skill.md)
+- [Development](docs/development.md)
+
+## Requirements
+
+Python 3.8+. No third-party runtime dependencies. A local [Ollama](https://ollama.com)
+or llama.cpp server is optional (for offline use).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Run `make test` before opening a PR.
+
+## License
+
+[MIT](LICENSE) © expert-mentor contributors.