quartz-note-creator

基于自然语言描述,使用适当的 YAML frontmatter 创建新的 Quartz 注释。当用户想要在其数字花园中创建笔记、文章、日记条目或模板文件时使用。

📖 中文导读:基于自然语言描述,使用适当的 YAML frontmatter 创建新的 Quartz 注释。当用户想要在其数字花园中创建笔记、文章、日记条目或模板文件时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: quartz-note-creator description: | Create new Quartz notes with proper YAML frontmatter. Use when: (1) User wants to create a new note in content/notes/ (2) User specifies a topic/title for a new note (3) User says "create a note about..." or "make a new note for..." (4) User wants to draft content with proper frontmatter Automatically adds author (Sushant Vema), timestamps (ISO format), and handles publish flag.

Quartz Note Creator

Create new notes in content/notes/ with proper Quartz frontmatter.

Usage

Use the scripts/create_note.py script:

python3 scripts/create_note.py "Note Title" [options]

Options:

  • -d, --description: Note description
  • -p, --publish: Set publish: true (default: false)
  • -t, --tags: Space-separated tags
  • -o, --output: Output directory (default: content/notes/)

Examples

Basic unpublished note:

python3 scripts/create_note.py "Machine Learning Basics"

Published note with description and tags:

python3 scripts/create_note.py "Kubernetes Guide" \
  -d "Notes on k8s deployment" \
  --publish \
  -t devops kubernetes cloud

Draft note:

python3 scripts/create_note.py "Weekend Plans" -t personal

Generated Frontmatter

---
title: "Note Title"
description: "Optional description"
author: "Sushant Vema"
date_created: 2026-01-17T11:14:47
date: 2026-01-17T11:14:47
publish: false
tags:
  - "tag1"
  - "tag2"
---

Field Descriptions

Field Value Notes
title User-provided Required
description User-provided or enriched Optional. Can be enhanced with context beyond user's exact words
author "Sushant Vema" Always set
date_created ISO timestamp Auto-generated
date ISO timestamp Auto-generated
publish true/false Default: false
tags List Optional

Description Guidelines

The description field is flexible and can be enriched by the agent:

  • User provides description: Use it as-is or enhance with additional context
  • User doesn't provide description: Create a concise, informative description based on the topic
  • Enrichment encouraged: Add technical context, use cases, or clarifying details that make the note more discoverable

Example enrichments:

  • User: "Create a note about PyO3"
  • Basic: "A way to wrap Rust logic into Python modules"
  • Enriched: "Rust-Python interoperability library for creating native Python extensions in Rust, providing performance benefits and type safety"

Filename Generation

  • Title is slugified (lowercase, dashes instead of spaces)
  • Example: "Machine Learning Basics" → machine-learning-basics.md
  • Placed in content/notes/ by default