convert

Convert raw text files into structured notes with YAML frontmatter and renamed titles.

20|5|Updated Nov 18, 2025
One-click install
npx skills add https://github.com/zby/llm-do --skill convert-zby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert
Source: https://github.com/zby/llm-do/tree/main/project_claw/skills/convert
Command: npx skills add https://github.com/zby/llm-do --skill convert-zby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill transforms raw text files into structured notes by adding essential metadata (frontmatter) and ensuring file naming consistency, making your knowledge base more organized and discoverable.

Core Features & Use Cases

  • Text to Note Conversion: Automatically adds YAML frontmatter (description, type, status, etc.) to plain text files.
  • Automatic Renaming: Renames files to match their # Title heading for better organization.
  • Backlink Updates: Safely updates existing links to files when they are renamed.
  • Use Case: You have a collection of meeting notes saved as plain .md files. Running /convert on them will add a status: seedling and a description to each, and rename files like meeting-notes-2023-10-27.md to meeting-2023-10-27.md if the title is # Meeting 2023-10-27.

Quick Start

Convert the note named 'my-raw-idea.md' into a structured note.

Frequently Asked Questions about convert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add YAML frontmatter to plain text notes?

Renaming markdown files to match their title headings is handled by parsing the file's `# Title` and renaming the file accordingly. This ensures your knowledge base files have consistent naming conventions directly derived from their primary heading.

Do backlinks update automatically when renaming markdown files?

You can convert raw meeting notes into structured notes by running the conversion command on plain `.md` files. The process assigns a default status like `seedling`, adds a description field, and renames files based on their heading for better organization.

What is the best way to organize raw text files into a structured knowledge base?

The best way to organize raw text files into a structured knowledge base is by adding YAML frontmatter and standardizing file names. This process makes unstructured text files discoverable and consistently categorized by automatically applying metadata and renaming files to match their titles.

Does the text-to-note conversion process overwrite existing frontmatter?

The text-to-note conversion process parses file content to identify existing frontmatter before adding new metadata. It safely integrates new fields like description and status into raw text files without blindly overwriting the YAML frontmatter you have already defined.