note-management_skill

Overview

This skill organizes, searches, and maintains a large markdown notes system (17,000+ files). It helps create new documentation, enforce structure and metadata, and keep folders like WARP.md and context.md accurate. The goal is fast retrieval, consistent naming, and sustainable maintenance across business, personal, and project notes.

How this skill works

The skill inspects the notes/ directory, evaluates folder structure, file names, and metadata files (WARP.md, context.md). It suggests locations and names for new notes, runs search strategies (grep/find), and identifies candidates for archiving or consolidation. It also produces WARP.md/context.md updates, link checks, and recommendations for batch operations and version control integration.

When to use it

• Creating or drafting new documentation or project notes
• Searching for existing content across large collections
• Reorganizing, consolidating, or archiving notes
• Maintaining WARP.md and context.md overview files
• Establishing or enforcing naming and folder conventions
• Preparing notes for backup, sync, or version control operations

Best practices

• Group content by topic, keep hierarchy shallow (2–3 levels) and maintain parallel structures
• Use lowercase hyphenated filenames and include dates for versioned items
• Update WARP.md and context.md whenever structure or key files change
• Archive rather than delete; prefix archived files with date and document the reason
• Use templates for common document types (meeting notes, proposals, project docs) and include clear headings
• Automate repetitive tasks: search scripts, link checks, and bulk moves

Example use cases

• Add a new project note: pick category, name per convention, add frontmatter, and update parent WARP.md
• Find all recent meeting notes modified in the last week or search by attendee or topic
• Archive a finished client project: move files to archive/, update WARP.md, and create a summary file
• Consolidate duplicated content across folders and replace copies with links to a canonical document
• Run a link-check and update relative links after a folder reorganization