Helper for managing ITLearn, a Quartz-based digital garden for IT/cybersecurity learning content with TWN Systems integration
Expert assistant for working with ITLearn, a Quartz 4.5.1-based digital garden that serves as the learning wing of TWN Systems. Transforms Obsidian notes into a professional web platform focused on digital sovereignty fundamentals.
ITLearn is a static site generator project using Quartz to publish IT/cybersecurity learning content from Obsidian-flavored Markdown files. The site emphasizes structured learning paths and community integration via TWN Commons.
**Tech Stack:**
**Content Structure:**
Before making changes, familiarize yourself with these core commands:
**Adding New Learning Paths:**
When creating a new learning path in `content/paths/[topic].md`, follow this structure:
```markdown
---
title: [Topic] Learning Path
draft: false
---
Why this topic matters and who it's for
What learners need before starting
Clear checkpoints with actionable items:
> [!TIP] Need guidance?
> Join the [TWN Commons on Discord](https://discord.gg/kgaMm6WJya) to ask questions and connect with other learners.
> [!NOTE] Bridge to TWN
> Deploy sovereign infrastructure: explore providers on [TWN Systems](https://twn.systems)
```
**Managing Drafts:**
Add `draft: true` to frontmatter for incomplete content. The RemoveDrafts() plugin automatically excludes these from builds.
**Markdown Features:**
**Site Configuration (`quartz.config.ts`):**
**Layout Configuration (`quartz.layout.ts`):**
Footer links should follow this template:
```typescript
footer: Component.Footer({
links: {
"TWN Systems": "https://twn.systems",
"TWN Commons": "https://discord.gg/kgaMm6WJya",
"GitHub": "https://github.com/[repository]",
},
}),
```
1. Run `npm run quartz build --serve`
2. Navigate to http://localhost:8080
3. Make changes to content files
4. Site rebuilds automatically
5. Config changes require restart
Always include TWN branding elements:
Before deploying changes:
1. Run `npm run check` - Verify TypeScript and formatting
2. Run `npm run format` - Auto-format code
3. Test locally with `npm run quartz build --serve`
4. Verify all learning paths have TWN integration callouts
5. Ensure no draft content is accidentally published
The site deploys to Cloudflare Pages:
**Adding a New Learning Path for "Containers":**
1. Create `content/paths/containers.md`
2. Use the learning path structure template
3. Add Docker/Podman resources
4. Include TWN Commons Discord callout
5. Add Bridge to TWN section mentioning container hosting providers
6. Test with `npm run quartz build --serve`
7. Commit and push
**Updating Site Theme:**
1. Edit `quartz.config.ts` under `theme.colors`
2. Run `npm run format`
3. Test locally
4. Verify visual consistency across pages
5. Commit changes
**Creating a Draft Note:**
```markdown
---
title: My Work in Progress
draft: true
---
Content here won't appear in production builds.
```
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/quartz-digital-garden-itlearn/raw