learn-planner

Generate 7-day learning plans, quizzes, and track your study progress locally for 20+ topics without needing an internet connection or account.

Security Scan

The skill's files, runtime instructions, and resource access match its stated purpose (local learning plans, quizzes, and a local progress file) and request no external credentials or unusual system privileges.

Purpose & Capability

The name/description (learning plans, quizzes, local progress) align with what is included: an embedded knowledge base, quiz generation, and local JSON storage. No unrelated services, credentials, or binaries are requested.

Instruction Scope

SKILL.md instructs running the bundled script for plan/quiz/progress operations and documents the local progress file path (~/.local/share/education-skill/progress.json). The provided script creates/reads that local file and uses only python3 and bash; it does not instruct reading unrelated system files or sending data externally.

Install Mechanism

There is no install spec — the skill is instruction-only with a bundled script. That is proportionate for a CLI-style local tool and avoids network installs or external package downloads.

Credentials

The skill requires no environment variables, credentials, or config paths beyond creating a directory under the user's home. Requested environment access is minimal and appropriate for storing local progress.

Persistence & Privilege

always is false and the skill does not request persistent platform-level privileges. It stores progress in its own directory and does not modify other skills or system-wide settings.

Assessment

This skill appears coherent and self-contained: it runs a bundled bash/python script, stores progress under ~/.local/share/education-skill, and needs only bash and python3. Before installing or running, you may want to: (1) inspect the full scripts/script.sh file yourself to confirm there are no unexpected network calls or commands you don't want executed; (2) run it in a restricted environment (or with a disposable user) if you prefer; and (3) be aware it will create and modify files in your home directory (~/.local/share/education-skill/progress.json). If you need offline operation, ensure python3 is available on your system.

education

Learning Plan Generator — Generate structured learning paths, quizzes, and track your study progress — all stored locally, no account required.

Commands

Command	Description	Example
plan	Generate a structured learning plan for a topic	plan "Python for Data Science"
quiz	Generate quiz questions to test your knowledge	quiz "Python for Data Science" 5
progress	Track and display your study progress	progress show / progress done "Day 1"

Usage

bash script.sh plan "topic name"
bash script.sh quiz "topic name" [num_questions]
bash script.sh progress show
bash script.sh progress done "milestone name"
bash script.sh progress reset

Features

• Generates 7-day learning plans with daily goals and curated free resources
• Covers 20+ topic areas: programming languages, frameworks, DevOps, math, and more
• Quiz generator with multiple-choice and open-ended questions
• Local JSON progress tracking (stored in ~/.local/share/education-skill/progress.json)
• No internet required — all content is built-in

Requirements

• bash >= 4.0
• python3 >= 3.7
• No external packages required (uses only stdlib)

Examples

$ bash script.sh plan "Docker"

📚 Learning Plan: Docker
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Duration  : 7 days
Level     : Beginner → Intermediate

Day 1: Introduction to Containers
  Goals:
    • Understand what containers are vs VMs
    • Install Docker Desktop / Docker Engine
    • Run your first container: docker run hello-world
  Resources:
    • Docker Official Docs — Get Started: https://docs.docker.com/get-started/
    • Play with Docker (free browser sandbox): https://labs.play-with-docker.com/
...

$ bash script.sh quiz "Python" 3

📝 Quiz: Python  (3 questions)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Q1. What is the output of: print(type([]))
  A) <class 'tuple'>
  B) <class 'list'>   ✓
  C) <class 'array'>
  D) <class 'dict'>

Q2. Which keyword is used to define a function in Python?
  A) function
  B) fn
  C) def   ✓
  D) lambda
...

$ bash script.sh progress show

📊 Study Progress
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Topic     : Docker
Started   : 2024-01-15
Completed : Day 1, Day 2
Remaining : Day 3, Day 4, Day 5, Day 6, Day 7
Progress  : ██████░░░░░░░░░░░░░░  2/7 days (29%)