# PowerShellOrg/PSKoans

A simple, fun, and interactive way to learn the PowerShell language through Pester unit testing.

Repository: https://github.com/PowerShellOrg/PSKoans
Canonical: https://ross.abutalabs.com/products/pskoans
Language: PowerShell
License: GPL-3.0
License Family: copyleft
Topics: powershell, powershell-module, pester, koans, hacktoberfest
Last push: 2024-09-03T22:08:21+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2981, "days_push": 729, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1873, forks 184 (observed 2026-08-28T04:05:47.086850+00:00)

## What it is
PSKoans is an interactive PowerShell module that teaches the PowerShell language through a series of failing Pester unit tests called koans. Learners progress from beginner to advanced concepts by filling in code to make each test pass, guided by the Show-Karma command.

## Use cases
- learn powershell from scratch interactively
- practice powershell by fixing failing pester tests
- brush up on intermediate and advanced powershell concepts
- teach a powershell workshop with hands-on exercises
- self-study powershell scripting through koans

## When to choose
- you want a fun, test-driven way to learn or refresh PowerShell
- you already have PowerShell 5.1+ and can install modules from the gallery
- you learn best by writing code to satisfy failing tests

## When to avoid
- you need a structured reference manual rather than exercise-based learning
- you have never used a command line and need guided GUI-based instruction
- you require Pester v5 compatibility without adjustments, as the project targets Pester v4 workflows

## Facets
- artifact type: learning-resource
- maturity: active
- function: testing, developer-tools
- domain: tutorials, developer-tools
- platform: cross-platform, windows, cli
- tags: powershell, pester, koans, interactive-learning, unit-testing, command-line, linux, macos

## Member repositories
- PowerShellOrg/PSKoans (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:47.086850+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:14:49.008510+00:00, confidence not recorded.
  - readme: https://github.com/PowerShellOrg/PSKoans (fetched 2026-08-28T04:05:47.086850+00:00, sha b8fcae416d98)
- Data as of 2026-08-30T08:39:29.467469+00:00.