Skills

Lithos Documentation Skill

Instructions for writing documentation in this vault.
Properties3
Is BaseNo
Iconi-lucide-file-text
Order2

The Lithos Documentation Skill (lithos-doc) guides the creation and maintenance of this documentation site.

Skill Path
The definition for this skill works with the Skill Framework and is located at .agent/skills/lithos-doc/SKILL.md.

Purpose

Ensures all documentation is consistent, uses correct Obsidian syntax, and properly leverages Nuxt Content features.

Critical Rules

  1. Strict Navigation Structure: Follow the numbered folder convention (1.guide, 2.features, etc.) to control sidebar ordering.
  2. Icon Consistency: Every note must have both icon and navigation.icon properties set in frontmatter using i-lucide-* format.
    icon: i-lucide-rocket
    navigation:
      icon: i-lucide-rocket
    
  3. Cross-Linking: Use wikilinks for internal navigation. Avoid absolute URLs for internal content.

Workflow

When adding a new documentation page:

  1. Determine Location: Choose the appropriate numbered directory (e.g., Writing Content goes in 1.guide).
  2. Create File: Use kebab-case filename (e.g., my-new-feature.md).
  3. Apply Frontmatter:
    • Set title.
    • Set description.
    • Set icon (doubled in navigation).
  4. Write Content: Use standard Markdown + MDC components.