DeepTutor CLI Skill

A skill that lets an agent set up the DeepTutor learning platform and run it from the terminal: knowledge bases, quizzes, solving

  • 58,697 ★ on the repository
  • Last commit
  • Apache-2.0
Skill

Extended access

Why this level

  • The platform sends materials and queries to the chosen language-model provider under your key.
  • Setup changes files in the `DEEPTUTOR_HOME` working directory and installs Python packages.
All reasons and checks

hkuds/deeptutor

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/deeptutor-cli-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The platform sends materials and queries to the chosen language-model provider under your key.
  • Setup changes files in the `DEEPTUTOR_HOME` working directory and installs Python packages.

This is third-party code. Review the repository files before installing.

What it does

DeepTutor CLI Skill is a `SKILL.md` file in the root of the DeepTutor repository, a personal learning platform. It tells an agent how to configure DeepTutor and use it entirely from the terminal. The skill covers first-time setup with the `deeptutor init` wizard, readiness checks with `deeptutor doctor`, inspecting configuration with credentials redacted and running capabilities: deep solve, quiz generation, deep research, visualization, math animation and a mastery path. Separate sections cover knowledge bases, Partners, memory, sessions, notebooks, providers and the server with the Web app. For diagnostics it points to the `docs-for-dev/AGENT_SETUP.md` guide.

Who it is for. Students, teachers and researchers who learn with DeepTutor and want an agent in the terminal to set up the platform, build a knowledge base and run a quiz or a solve.

Good fit when

  • DeepTutor was just cloned and an agent has to do the first setup without revealing keys.
  • The platform is installed but does not start: the agent runs `deeptutor doctor` and looks for the cause.
  • Notes and PDFs need to become a knowledge base that is queried from the terminal.
  • A quiz on a course topic or a deep solve of a task is wanted without opening the web interface.
  • The DeepTutor API server or the full Web app has to be started with a single request to the agent.

Not a fit when

  • DeepTutor is not installed and will not be: the skill covers only this platform.
  • General study help without a dedicated platform is enough: an ordinary chat with the agent will do.
  • A working web interface is needed without Node.js and Python: installing from source requires both.

Example request

Set up DeepTutor in this folder non-interactively, check readiness with doctor and create a knowledge base from the PDFs in the lectures directory.

Limitations

The skill works only together with DeepTutor: it needs Python 3.11–3.14 and, for the Web UI from source, Node.js 22 LTS. The platform needs a language-model provider key, and `deeptutor doctor --online` makes a real request that spends quota. Some capabilities need extra packages from `deeptutor[full]`. The skill's commands depend on the version, so check `--help` of the installed one if they differ.

How to disable. Delete the skill file from the agent's skills directory. The platform itself is removed separately along with the `DEEPTUTOR_HOME` working directory.

FAQ

What is this skill?

The `SKILL.md` file from the root of the DeepTutor repository. It teaches an agent to configure the platform and work with it through `deeptutor` commands.

How do I install the platform itself?

For release 1.7.0 the skill names `pip install "deeptutor[full]"`, which installs the CLI together with the packaged Web app. A plain `deeptutor` gives only the CLI and SDK core.

How do I check that everything is ready?

`deeptutor doctor --format json` checks local readiness. The `--online` variant makes a live model request and spends provider quota.

Does the skill see my keys?

No. By its instructions keys come from environment variables via `api_key_env`, and `deeptutor config show` redacts values.

Which capabilities can be run?

Deep solve, quiz generation, deep research, visualization, math animation and a mastery path. Basic chat and questions are part of the core.

Discussion

No questions or reviews yet.

Skills

A tutoring skill for STEM and AI: it finds the knowledge gap first, then teaches one step and checks understanding

SkillMinimal access267Repository stars

A set of skills that turn an AI agent into a tutor built on cognitive science, from school to career and social skills

SkillMinimal access595Repository stars

A desktop app and skm CLI: one copy of each skill in a central hub, symlinked into every AI tool

CLIExtended access1.1KRepository stars
Official

The socratic-tutor skill turns an agent into a strict tutor: a diagnostic, a skill map with levels 0-5 and a final assessment

SkillMinimal access7.9KRepository stars

A skill that turns PDFs, docs and a codebase into an Obsidian study vault: structured notes for self-study

SkillExtended access1.4KRepository stars

A collection of skills for decisions and projects: strategy, market research, thinking, data analysis, docs and slides.

PluginMinimal access109Repository stars

README in short

DeepTutor is a personal learning platform with knowledge bases, memory, notebooks and interactive books. The root `SKILL.md` gives agents a CLI setup path, and detailed developer guides live in `docs-for-dev/`.

README badge

Original SKILL.md

---
name: deeptutor-cli
description: Configure, manage, and use DeepTutor through its CLI, including capabilities, knowledge bases, partners, memory, sessions, notebooks, providers, skills, and the server or Web app.
---

# DeepTutor CLI Skill

> Teach your AI agent to configure, manage, and use DeepTutor, an intelligent learning platform, entirely through the command line.

Report a problem