DeepTutor CLI
HKUDS/DeepTutor
Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.
Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal.
Install Subject
$ npx skills add madhvantyagi/Gnos --skill subject -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install madhvantyagi/Gnos subject --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/subject .claude/skills/subject && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .claude/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/madhvantyagi/Gnos/tree/main/skills/subjectType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add madhvantyagi/Gnos --skill subject -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install madhvantyagi/Gnos subject --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/subject .agents/skills/subject && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .agents/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add madhvantyagi/Gnos --skill subject -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install madhvantyagi/Gnos subject --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/subject .cursor/skills/subject && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .cursor/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/madhvantyagi/Gnos.git --path skills/subject--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add madhvantyagi/Gnos --skill subject -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install madhvantyagi/Gnos subject --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/subject .gemini/skills/subject && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .gemini/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install madhvantyagi/Gnos subjectInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add madhvantyagi/Gnos --skill subject -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/subject .github/skills/subject && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .github/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add madhvantyagi/Gnos --skill subject -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install madhvantyagi/Gnos subject --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/madhvantyagi/Gnos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/subject .opencode/skills/subject && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "subject" agent skill from https://github.com/madhvantyagi/Gnos/tree/main/skills/subject into .opencode/skills/subject/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "subject", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
subject- GitHub stars
- 337
- Token cost
- ~2.3k tokens
- SKILL.md length
- 1,172 words
- Files
- 23 (incl. scripts, references)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal.
- Works in 6 steps: State the learner's intended action:… → Name the field that decides whether that… → Check the selected guide's prerequisites… → …
- Education work in your project
- SKILL.md covers Route the learning job, Subjects and teachers, Use the selected guide and Bridges, plus 2 more sections
- Runs Python scripts from its folder; calls python3
What it does
Subject is an agent skill from madhvantyagi/Gnos. Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal.
Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 25 other files, including scripts and reference files (for example `references/biology.md`, `references/computer-science.md` and `references/economics.md`).
It sits in Education. The repository describes itself as: Teaching harness , help you to learn anything , It teaches like real teacher , design curriculum , generate videos , simulations , images , pdfs , tracks your learning style etc. The licence is MIT.
When your agent uses it
- Education work in your project
Example prompts
- “/subject”
Requirements
- Python 3
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- State the learner's intended action: derive, predict, implement, interpret,
- Name the field that decides whether that action is correct. That is the lead
- Check the selected guide's prerequisites and distinctions. Add a supporting
- Keep one lead teacher. A supporting teacher supplies one bounded bridge and
- Read the guide's matching subfield section when planning the course and lesson.
- Record the selected subject guide in the topic's skill_routes. Lesson
What it can do on your machine
Read from SKILL.md and the folder at commit be0e47c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Subject loads about 2.3k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 32 tokens; SKILL.md has 1,172 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from madhvantyagi/Gnos at commit be0e47c, republished under its MIT licence (© madhvantyagi). 1,172 words, ~2,314 tokens.
Download SKILL.mdSave it as
.claude/skills/subject/SKILL.md (or your agent's skills folder). This skill also uses 22 other files; get the full folder from GitHub.- name
- subject
- description
- Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal.
Subject routing
Select the subject from the capability the learner wants to build, not from the first technical noun in the request. A biological dataset may need a statistics lesson. A programming example may expose an algebra gap. A historical price series still needs historical source judgment.
Route the learning job
- State the learner's intended action: derive, predict, implement, interpret, compare, diagnose, or argue from evidence.
- Name the field that decides whether that action is correct. That is the lead subject.
- Check the selected guide's prerequisites and distinctions. Add a supporting subject only for a named bottleneck.
- Keep one lead teacher. A supporting teacher supplies one bounded bridge and returns the lesson to the lead subject.
- Read the guide's matching subfield section when planning the course and lesson. Course design uses its starting point and likely confusions to order ideas. Lesson design uses its suggested views to explain those ideas.
- Record the selected subject guide in the topic's
skill_routes. Lesson design records media skill routes inlesson.json.
Do not route by vocabulary alone. “Gradient” does not make every optimization question mathematics; the domain subject owns what the objective and variables mean. “Code” does not make a biological inference computer science; CS owns the implementation while biology owns the claim.
Subjects and teachers
| Subject ID | Guide | Lead teacher |
|---|---|---|
| math | Mathematics | teachers/math/SOUL.md |
| physics | Physics | teachers/physics/SOUL.md |
| history | History | teachers/history/SOUL.md |
| biology | Biology | teachers/biology/SOUL.md |
| economics | Economics | teachers/economics/SOUL.md |
| computer-science | Computer science | teachers/computer-science/SOUL.md |
| accounting | Accounting | Use an existing teacher only for a named bridge |
| artificial-intelligence | Artificial intelligence | Use an existing teacher only for a named bridge |
| business | Business | Use an existing teacher only for a named bridge |
| chemical-engineering | Chemical engineering | Use an existing teacher only for a named bridge |
| political-science | Political science | Use an existing teacher only for a named bridge |
| psychology | Psychology | Use an existing teacher only for a named bridge |
Do not invent a persona for a subject without a teacher. Set teacher to
null, or assign an existing teacher only when that teacher owns a real
supporting method. The subject still owns its evidence and interpretation.
Use the selected guide
Read the selected subject file in full. Its subfield map is a starting structure, not a complete taxonomy. For an unlisted specialty, inspect a primary, official, or academic source before designing a sustained course. Do not imply that an introductory textbook covers every advanced branch.
Read a linked deep reference only when the guide sends you there for detailed prerequisites, sources, examples, or visual patterns. Do not preload every subject reference.
Use python3 skills/subject/scripts/resources.py --subject physics to list
curated sources. Add --query vectors to narrow the list. A catalog entry or
landing page is not proof that the needed section was inspected.
Bridges
- AI and machine learning: artificial intelligence owns model and evaluation claims; CS owns implementation; math owns the needed linear algebra, probability, derivatives, or optimization.
- Biophysics: biology owns the mechanism when the question is biological; physics owns forces, diffusion, energy, or measurement for the named bridge.
- Economic history: history owns chronology and source context; economics owns an explicitly conditional model. Neither substitutes for the other's evidence.
- Quantitative biology, psychology, economics, or political science: the domain owns the question and interpretation; math owns the statistical tool.
- Chemical engineering: chemical engineering owns the system boundary and process assumptions; physics, math, and CS support transport, equations, and simulation.
- Business and accounting: business owns the operating decision; accounting owns recognition and reconciliation; economics owns the stated market model.
Carry the learner's last sound step, notation, units, and unresolved question through every bridge. Do not stage a panel discussion.
Show full SKILL.md (574 more words)Show less
Use subject guidance in the lesson
The subject guide says what the learner must notice, work out, or check in this field. Lesson design uses that advice to choose explanations, examples, practice, and media. Read the guide before choosing blocks. A lesson may use several forms when each helps with a different step of the same idea. Every ready lesson needs at least two distinct teaching forms. The subject guide helps choose a useful pair; it does not assign a fixed pair to every topic. Exercise and feedback blocks are practice, not one of the two forms. There is no upper limit when more forms deepen the explanation. For the current topic, carry three decisions into lesson design: the concrete starting case, the distinction most likely to need explanation, and what the learner could inspect or change to understand it. Use the matching subfield section for its research checks and representation choices. Adapt them to the learner's question. Read deeper references when that section leaves a prerequisite, mechanism, or evidence question unresolved. For a visual block, specify the relation to reveal and the values or sources it must preserve. Select graphs and maps through representation choices. Use JSXGraph for mathematical coordinates and linked quantities, Excalidraw for a fixed structural sketch, and Pinepaper for a composed scene. The media skill explains construction and export; the subject guide keeps the science or evidence correct.
| Workflow | What it produces | Route |
|---|---|---|
| Subject teacher | Explanation, derivation, code, bullets, and exercises | This skill and the selected subject guide |
| Image generation | Still illustration or labeled image | The host's existing image-generation skill or tool, following the instructions below |
| Manim voice animation | Narrated rendered motion with subtitles | skills/manim-voice-animation/SKILL.md |
| Rendered and inspected handout or source packet | skills/pdf/SKILL.md | |
| Excalidraw MCP | Quick inspectable relationship, process, or boundary diagram | Excalidraw workflow and the selected subject guide |
| JSXGraph | Mathematical graph or coordinate construction | JSXGraph workflow and the selected subfield guidance |
| Pinepaper MCP | Composed diagram or changing scene | Pinepaper workflow and the selected subfield guidance |
| Simulation | Learner-controlled graph or model | Self-contained HTML registered through manage_artifact.py |
For generated images, invoke the host's existing image-generation skill
(such as Codex's imagegen) and follow its instructions. Give it the lesson's
visual brief and keep the returned image with the course artifacts. Inspect
the result before the lesson coordinator registers it. GNOS does not need a
separate image-generation skill. If the host has no image-generation capability,
report that and revise the representation rather than claiming an image exists.
Image generation and the MCP references use the subject route. Declare
skills/subject/SKILL.md and the selected subject guide in the course topic.
Declare any media producer in the lesson's skill_routes; use
skills/subject/SKILL.md for a generated image block. The host skill is
invoked from these instructions, so its installation path does not belong in
course.json.
Keep one case across forms. Identify which object, equation term, code step, or source passage corresponds to each visible part, then state what the new view adds. Change a meaningful condition for practice and ask which part of the reasoning survives. Avoid rebuilding the same visual in several tools.
During lesson design, read
skills/lesson-design/references/representation-choices.md for the medium
choices. Each delegated lesson worker receives the selected subject guide and
only the deep workflow reference its block needs.
Source discipline
Read source-use.md for source selection and downloads. The lead subject decides what counts as evidence. A simulation, generated image, or explanatory animation is a model unless it directly and accurately presents a cited source.
© madhvantyagi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 22 other files (scripts, references) in skills/subject of madhvantyagi/Gnos.
- SKILL.md
- references/biology.md
- references/computer-science.md
- references/economics.md
- references/history.md
- references/math.md
- references/physics.md
- references/political-science.md
- references/resources.json
- references/source-use.md
- scripts/resources.py
- subjects/accounting.md
- subjects/artificial-intelligence.md
- subjects/biology.md
- subjects/business.md
- subjects/chemical-engineering.md
- subjects/computer-science.md
- subjects/economics.md
- … and 5 more
Open the folder on GitHubat commit be0e47c
Compare with similar skills
Subject next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Subject this skillmadhvantyagi/Gnos | 337 | — | ~2.3k | Automated safety check: Pass | MIT | |
| DeepTutor CLIHKUDS/DeepTutor | 41k | — | ~2.8k | Automated safety check: Pass | Apache-2.0 | |
| AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch | 66k | — | ~2k | Automated safety check: Pass | MIT | |
| Deep Reading Analystginobefun/deep-reading-analyst-skill | 353 | 4 repos | ~3.6k | Automated safety check: Pass | MIT | |
| OpenMAIC Setup and ExtensionTHU-MAIC/OpenMAIC | 40k | — | ~1.7k | Automated safety check: Notes | MIT | |
| Codebase to Coursezarazhangrui/codebase-to-course | 5.7k | — | ~4.4k | Automated safety check: Pass | None |
Similar skills
AI Engineering Placement Quiz
rohitg00/ai-engineering-from-scratch
Runs a 10-question quiz across five areas to place a learner in the AI Engineering from Scratch curriculum, so they skip what they already know.
Deep Reading Analyst
ginobefun/deep-reading-analyst-skill
Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems…
OpenMAIC Setup and Extension
THU-MAIC/OpenMAIC
Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.
Codebase to Course
zarazhangrui/codebase-to-course
Turns a codebase into an interactive single-page HTML course for non-technical learners, with scroll modules, animated diagrams, quizzes and plain-English code translations.
Zhang Xuefeng Perspective
alchaincyf/zhangxuefeng-skill
Answers education and career questions in the voice of Zhang Xuefeng, looking up current employment and admissions data before giving a direct verdict.
More from madhvantyagi/Gnos
All 12 skills in this repoCourse Design
madhvantyagi/Gnos
Design and revise a course's goal, progression, prerequisites, and sources.
Course Viewer
madhvantyagi/Gnos
Show an enrolled course and its lessons. An agent skill from madhvantyagi/Gnos.
Khan Academy
madhvantyagi/Gnos
Find a Khan Academy video fast and add it only on a strong match.
Learner Tracking
madhvantyagi/Gnos
Record what the learner does and adapt the course to it in real time.
Lesson Design
madhvantyagi/Gnos
Develop the current topic into a connected lesson. An agent skill from madhvantyagi/Gnos.
Manim Voice Animation
madhvantyagi/Gnos
Make Manim teaching animations with narration and subtitles when motion helps a concept.
Related
Categories
Questions about Subject
What does Subject do?
Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal. Subject is an agent skill from madhvantyagi/Gnos. Select the lead subject, supporting bridges, teacher, sources, and field-specific teaching guidance for a learning goal.
When should I use Subject?
Subject fits situations like: education work in your project.
How do I install Subject in Claude Code?
Run `npx skills add madhvantyagi/Gnos --skill subject -a claude-code`. Or copy the skill folder (skills/subject in madhvantyagi/Gnos) into .claude/skills/subject in your project. Claude Code loads it when a task matches its description.
How do I install Subject in Codex?
Run `npx skills add madhvantyagi/Gnos --skill subject -a codex`. Or copy the skill folder (skills/subject in madhvantyagi/Gnos) into .agents/skills/subject in your project. Codex loads it when a task matches its description.
Can I use Subject in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add madhvantyagi/Gnos --skill subject -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/subject, .gemini/skills/subject, .github/skills/subject and .opencode/skills/subject in your project.
What does Subject need to run?
Going by SKILL.md and its folder, Subject needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Subject access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Subject safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Subject use?
Subject is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Subject use?
About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.
What are the alternatives to Subject?
Skills that share tags, products or a category with Subject: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 66k stars), Deep Reading Analyst (ginobefun/deep-reading-analyst-skill, 353 stars) and OpenMAIC Setup and Extension (THU-MAIC/OpenMAIC, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Subject?
madhvantyagi (a GitHub user) maintains it in madhvantyagi/Gnos, which has 337 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.
Source: madhvantyagi/Gnos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.