Skip to content
Back to search

gnos

SkillWorks with Claude CodeGitHub

A teaching harness that diagnoses the learner's reasoning gap and selects the right teacher, subject guidance, and learning artifact.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/madhvantyagi/Gnos with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/madhvantyagi/Gnos'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/madhvantyagi--gnos/badge.svg)](/listings/madhvantyagi--gnos)

HTML

<a href="/listings/madhvantyagi--gnos"><img src="/api/listings/madhvantyagi--gnos/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "gnos",
  3. "displayName": "GNOS",
  4. "version": "0.2.0",
  5. "description": "A teaching harness that diagnoses the learner's reasoning gap and selects the right teacher, subject guidance, and learning artifact.",
  6. "author": {
  7. "name": "Madhvan Tyagi",
  8. "url": "https://github.com/madhvantyagi"
  9. },
  10. "homepage": "https://github.com/madhvantyagi/Gnos",
  11. "repository": "https://github.com/madhvantyagi/Gnos",
  12. "license": "MIT",
  13. "keywords": ["education", "teaching", "learning"]
  14. }
README.md · README · 150 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/hero.png" alt="GNOS artwork" width="100%" />
  3. </p>
  4. <p align="center">
  5. <strong>Turn your coding agent into a teacher that builds a course around you.</strong>
  6. </p>
  7. <p align="center">
  8. <a href="https://github.com/madhvantyagi/Gnos/stargazers"><img src="https://img.shields.io/github/stars/madhvantyagi/Gnos?style=social" alt="Star GNOS on GitHub" /></a>
  9. &nbsp;·&nbsp;
  10. <a href=".codex-plugin/plugin.json">Codex plugin</a>
  11. &nbsp;·&nbsp;
  12. <a href=".claude-plugin/plugin.json">Claude Code plugin</a>
  13. &nbsp;·&nbsp;
  14. <a href=".cursor-plugin/plugin.json">Cursor plugin</a>
  15. &nbsp;·&nbsp;
  16. <a href="LICENSE">MIT license</a>
  17. </p>
  18. ## What is GNOS?
  19. GNOS is a teaching harness made of skills, scripts, and visual tools. Tell it what you want to learn. For a course, it asks how deep you want to go and how much time you have, uses course materials such as university syllabi, textbooks, and documentation to plan a route, then builds the first lesson. Subagents make its lesson blocks; GNOS reviews and joins them before asking if you want to see the course.
  20. As you work, GNOS records what you tried, where your reasoning broke, and what you could do independently. It uses that evidence to adjust upcoming lessons and exercises. The course grows with you.
  21. ## Star history
  22. <p align="center">
  23. <a href="https://github.com/madhvantyagi/Gnos/stargazers">
  24. <img src="assets/star-history-light.svg" alt="GNOS GitHub stars over time, based on recorded daily additions" width="100%" />
  25. </a>
  26. </p>
  27. ## Study your course in a browser
  28. Just ask GNOS to show your course in the browser. It routes the request to the `course-viewer` skill, which renders the curriculum and current lesson as a study page. Open a topic to read its lesson, work through exercises, and follow its sources and learning materials.
  29. <p align="center">
  30. <img src="assets/course-viewer-rl-to-grpo.png" alt="GNOS course viewer showing the RL to GRPO curriculum and selected topic details" width="100%" />
  31. </p>
  32. <p align="center"><em>Browse the curriculum and open a topic to study it in the course viewer.</em></p>
  33. A true slideshow can't run inside a README, so here is the closest thing — click each frame to expand it:
  34. <details>
  35. <summary><strong>Frame 1 · Simulation</strong> — run route policies on the building grid</summary>
  36. <br />
  37. <p align="center">
  38. <img src="assets/lesson-simulation.png" alt="Grid simulation where the learner runs courier route policies" width="680" />
  39. </p>
  40. </details>
  41. <details>
  42. <summary><strong>Frame 2 · Lesson video</strong> — watch a narrated lesson block</summary>
  43. <br />
  44. <p align="center">
  45. <img src="assets/lesson-video.png" alt="Rendered lesson video on the Bellman equation" width="680" />
  46. </p>
  47. </details>
  48. ## Why does learning with AI still feel hard?
  49. Frontier models know a great deal, but a good answer is only one part of teaching. Learning a large subject also takes a coherent route, a diagnosis of mistakes, and a way to make abstract ideas visible. GNOS gives a coding agent that structure.
  50. | The problem | What GNOS does |
  51. | --- | --- |
  52. | **The voice feels generic** | Subject-specific teachers use `SOUL.md` files to guide their explanations and judgment. This builds on my earlier [SOUL.md project](https://github.com/madhvantyagi/SOUL.md). |
  53. | **Lessons lose the thread** | A living course plan and learner records keep topics, prior attempts, and the next step together across sessions. |
  54. | **A correct answer gets mistaken for understanding** | Learner tracking distinguishes seeing an explanation, solving with help, and solving independently; the next exercise responds to the evidence. |
  55. | **Everything becomes text** | GNOS can choose diagrams, images, simulations, narrated animations, or PDF handouts when that format helps explain the idea. Visual tools and media dependencies vary by environment. |
  56. ## Get started
  57. Start with Git, Python 3, and your preferred coding agent installed. Codex, Claude Code, and other agents use a local checkout. Cursor adds the skills from Customize, in the section below.
  58. Clone GNOS once and use this folder as your learning workspace:
  59. ```sh
  60. git clone https://github.com/madhvantyagi/Gnos.git
  61. cd Gnos
  62. ```
  63. ### Codex
  64. Install the [plugin](https://developers.openai.com/codex/plugins/) through the Codex CLI:
  65. ```sh
  66. codex plugin marketplace add madhvantyagi/Gnos --ref main
  67. codex plugin add gnos@gnos
  68. ```
  69. Start a new Codex session in `Gnos`, or open the folder in the Codex app and start a new task. Ask:
  70. > Use GNOS. Read `skills/learning-orchestrator/SKILL.md` in this workspace and teach me [topic].
  71. ### Claude Code
  72. From `Gnos`, launch Claude Code with the plugin:
  73. ```sh
  74. claude --plugin-dir .
  75. ```
  76. Enter `/gnos:learning-orchestrator Teach me [topic]`. Repeat the launch command each session; [`--plugin-dir` is session-only](https://code.claude.com/docs/en/plugins/create#load-a-plugin-for-one-session).
  77. ### Cursor
  78. 1. Open **Customize**.
  79. 2. Add this repository:
  80. ```text
  81. https://github.com/madhvantyagi/Gnos
  82. ```
  83. 3. Open a new agent chat and send:
  84. > Use GNOS. Read `skills/learning-orchestrator/SKILL.md` and teach me [topic].
  85. That installs the teaching skills. These buttons install the diagram servers:
  86. [![Add Excalidraw to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=excalidraw&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmV4Y2FsaWRyYXcuY29tL21jcCJ9)
  87. Excalidraw
  88. [![Add Pinepaper to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=pinepaper&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi1wIiwiQHBpbmVwYXBlci5zdHVkaW8vbWNwLXNlcnZlckAxLjYuNyIsIi1wIiwicHVwcGV0ZWVyQDI1LjkuMCIsInBpbmVwYXBlci1tY3AiXSwiZW52Ijp7IlBJTkVQQVBFUl9FWEVDVVRJT05fTU9ERSI6InB1cHBldGVlciIsIlBJTkVQQVBFUl9IRUFETEVTUyI6InRydWUiLCJQSU5FUEFQRVJfVE9PTEtJVCI6ImFnZW50IiwiUElORVBBUEVSX1ZFUkJPU0lUWSI6ImNvbXBhY3QiLCJQSU5FUEFQRVJfU0NSRUVOU0hPVF9NT0RFIjoib25fcmVxdWVzdCJ9fQ%3D%3D)
  89. Pinepaper
  90. Approve Excalidraw and Pinepaper if Cursor asks. To keep a course in a local folder, clone the repository, open that folder, and send the same message. The folder loads the same skills.
  91. ### OpenCode, Antigravity, and other agents
  92. Open the `Gnos` folder as your workspace. For **OpenCode**, run `opencode` from that folder; for **Antigravity**, open it in the editor. Send:
  93. ```text
  94. Read AGENTS.md, then skills/learning-orchestrator/SKILL.md.
  95. Use GNOS to teach me [topic]. Keep courses and progress in this workspace.
  96. ```
  97. This uses GNOS directly from its files; your agent needs local file and terminal access. [OpenCode also loads `AGENTS.md` automatically](https://opencode.ai/docs/rules/). Keep the repository together so its teachers, references, and scripts remain available.
  98. **Visual tools:** Codex and Claude Code load the server definitions in [`.mcp.json`](.mcp.json). In Cursor, use the Add to Cursor buttons above, or open the folder so [`.cursor/mcp.json`](.cursor/mcp.json) loads the same servers. For [OpenCode](https://opencode.ai/docs/mcp-servers/) or [Antigravity](https://antigravity.google/docs/mcp), configure those servers using the host's MCP format. Pinepaper needs Node.js/npm; image generation uses your agent's available tools, while PDF and video lessons need their own dependencies.
  99. For a course, share your goal, starting point, depth, and available time. To study the result, ask: **“Show my course in the browser.”**
  100. ## Help it grow
  101. GNOS grows through its users. If it helps you learn something hard, [share what worked or broke](https://github.com/madhvantyagi/Gnos/issues) and [star the repo](https://github.com/madhvantyagi/Gnos/stargazers) so others can find it.

Version history

  • v0.2.010/28/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.