Skip to content
Back to skills

Setup

ASecurity

First-time set-up for the learn plugin - checks Python, then either makes a new study vault in the current folder (with an optional example course) or connects an existing folder of notes. Use when someone has just installed the plugin or asks how to start.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentspythonfrontend

Works with

  • claude code
  • cli

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add jlu1023/learning-stack --skill setup --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Setup?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Setup
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/jlu1023-setup/badge)](https://www.skillsdirectory.com/skills/jlu1023-setup)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: setup
description: First-time set-up for the learn plugin - checks Python, then either makes a new study vault in the current folder (with an optional example course) or connects an existing folder of notes. Use when someone has just installed the plugin or asks how to start.
disable-model-invocation: true
---

Set the learner up in the current folder. Keep it short: a few questions, then do it.

1. **Check Python.** Run `VL doctor` (`VL` is the engine command in the `method` skill: `python3` on macOS and Linux, `py -3` on Windows, with the others as fallbacks). If none of them runs, or the version is below 3.10, stop and say: "The plugin needs Python 3.10 or later, which is free: install it from https://www.python.org/downloads/ (on Windows, tick 'Add python.exe to PATH'), then run /learn:setup again." Nothing else needs installing.

2. **Ask two questions** through `AskUserQuestion`:
   - **Notes:** "Start a new study vault here" (the folder is empty, or new to studying) or "Use the notes already in this folder" (connect them, read-only) or "Use notes in another folder".
   - **Editor:** "Obsidian" (recommended: links, tables and diagrams render as you read) or "Another editor (VS Code, Typora, a text editor)".

3. **A new vault:**
   - Ask whether to include the small example course (COURSE101, Introductory Probability), which shows every feature and can be deleted later. Default yes.
   - Run `VL init . --frontend <obsidian|plain>` (add `--no-example` if they said no). It never overwrites a file already in the folder; mention any it kept.
   - Then tell them, in at most six lines:
     - Obsidian: open this folder with **Open folder as vault**, allow community plugins, and install **Dataview** (for the review tables). Other editors need nothing.
     - To try it: `/learn:primer COURSE101 1`, then `/learn:teach COURSE101`.
     - To add a course: put its slides or notes (PDFs are fine) in `Sources/courses/<CODE>/` and run `/learn:ingest` on a file.
   - Mention, in one line, that Claude Code asks before each engine command, and that choosing "Yes, and don't ask again" at the first prompt stops that (SETUP.md, Permission prompts, has a rule they can add themselves). Never edit Claude Code's settings or permission files yourself.

4. **Existing notes** (this folder or another): read `${CLAUDE_PLUGIN_ROOT}/skills/connect/SKILL.md` and carry out its steps for that folder (the `connect` skill only starts when the learner types it, so follow the file rather than invoking it). For a read-only, shared or synced folder, ask whether to keep the state elsewhere with `--state-dir`. Use their editor answer as the frontend, so connect does not ask again. Never write anything into their notes folder except the `_learn/` state folder.

5. **Optional extras.** Only if `VL doctor` shows them missing and only in one line each, mention what they add: mermaid-cli (diagram checks, roadmap images for editors without Mermaid) and PyYAML (rare YAML forms). Say plainly that neither is needed.

6. **The app.** In one line, mention that `/learn:app` opens Study Desk, an optional page in the browser with typeset maths and a tab per course, and that its tutor acts in this folder without asking (it says so before it starts). Do not start it from here.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.