Files
skillshare/website/docs/learn/with-playground.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00

3.4 KiB

sidebar_position
sidebar_position
6

Try skillshare in the Playground

A pre-configured Docker sandbox with demo skills, audit rules, and a project — ready to explore in seconds.

Prerequisites

  • Docker and Docker Compose installed
  • Clone the skillshare repo: git clone https://github.com/runkids/skillshare.git

Start the Playground

cd skillshare
make playground

This single command:

  1. Builds the sandbox Docker image (Go toolchain included)
  2. Compiles the skillshare binary inside the container
  3. Initializes global mode with all targets auto-detected
  4. Creates demo skills (clean, warning, critical) across categories
  5. Sets up a demo project with project-level skills and custom audit rules
  6. Drops you into an interactive shell — ready to explore

What's Inside

Demo Skills (Global)

Skill Category Audit Findings
audit-demo-clean root None (clean baseline)
deploy-checklist devops/ None
audit-demo-ci-release security/ HIGH + MEDIUM (sudo, external URLs)
audit-demo-debug-exfil security/ CRITICAL (credential exfiltration)
audit-demo-external-link security/ LOW (external URLs)
audit-demo-dangling-link security/ LOW (broken local links)

Demo Project (~/demo-project)

A pre-configured .skillshare/ project with:

  • hello-world — clean project skill
  • demos/audit-demo-release — release helper with audit warnings
  • guides/code-review — nested code review guide
  • Custom audit-rules.yaml with a TODO/FIXME policy rule

Custom Audit Rules

Both global and project level audit-rules.yaml are pre-configured so you can see how rule customization works — enable/disable rules, add custom patterns, set allowlists.

Things to Try

# Check what's installed
skillshare status
skillshare list

# Run a security audit — see findings across severity levels
skillshare audit

# Try project mode
cd ~/demo-project
skillshare status          # auto-detects project mode
skillshare audit           # project-level scan with custom rules

# Launch the web dashboard (port 19420)
skillshare-ui              # global mode
skillshare-ui-p            # project mode

# Explore nested skills
ls ~/.config/skillshare/skills/security/
ls ~/.config/skillshare/skills/devops/

Bare Mode

Start with a clean slate — no auto-init, no demo content:

./scripts/sandbox_playground_up.sh --bare
./scripts/sandbox_playground_shell.sh

Useful for testing skillshare init from scratch.

Stop the Playground

make playground-down

Data persists in a Docker volume (playground-home). Next make playground picks up where you left off.

Architecture

The playground runs in a read-only Docker container with security hardening:

  • read_only: true — filesystem is immutable except for designated volumes
  • cap_drop: ALL — no Linux capabilities
  • no-new-privileges — prevents privilege escalation
  • Writable volumes: /sandbox-home (persistent), /tmp (tmpfs, 256 MB)
  • Port 19420 forwarded for the web dashboard

The workspace is mounted read-only from the host repo — you can edit code on your machine and rebuild inside the container.

What's Next?