ai-notes

Manage AI notes in ~/Compost/AI-Notes with read, list, and write operations.

43|4|Updated Dec 19, 2018
One-click install
npx skills add https://github.com/lambdalisue/dotfiles --skill ai-notes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-notes
Source: https://github.com/lambdalisue/dotfiles/tree/main/home/claude/skills/ai-notes
Command: npx skills add https://github.com/lambdalisue/dotfiles --skill ai-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill organizes AI-focused notes, provides predictable output paths, and enables quick listing of recent documents and AI action plans. It auto-triggers when notes are read or written.

Core Features & Use Cases

  • Output path generation: Generates Japanese-named folders like ~/Compost/AI-Notes/2025-12/24-0821-<title>.md
  • Note management: List recent notes, view titles, and navigate quickly
  • Reading & writing flow: Reads notes in Japanese with Mermaid diagrams for required visuals
  • Use Case: When drafting an implementation plan, create a new note with a generated path and then list it.

Quick Start

Generate a single note path: deno run -A ~/.claude/skills/ai-notes/notes.ts generate "<title>" Generate multiple notes: deno run -A ~/.claude/skills/ai-notes/notes.ts generate "<title>" --multiple List recent notes: deno run -A ~/.claude/skills/ai-notes/notes.ts list

Frequently Asked Questions about ai-notes

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

FAQPage Schema
How do I organize and manage notes with auto-generated file paths?▼

This Skill generates organized note paths automatically in ~/Compost/AI-Notes with year-month subfolders and timestamped filenames, letting you focus on content while the system handles file structure and indexing by H1 title.

Can I quickly list and browse recent notes I've created?▼

Yes, the list command retrieves recent notes with limit and offset parameters, displaying titles extracted from H1 headers so you can navigate your note collection without manual searching.

How do I generate paths for new implementation plans and notes?▼

Run the generate command with a title to create single or multiple note paths in Japanese-named folders like 2025-12/24-0821-<title>.md, with the option to batch-generate multiple paths at once.

What file format and structure does this Skill expect for notes?▼

Notes use Markdown format with an H1 title at the top for indexing, and support Mermaid diagrams for required visuals, organized in the ~/Compost/AI-Notes base directory with predictable paths.

Does this Skill work with Japanese note titles and content?▼

Yes, the Skill is designed for Japanese-named folders and reads notes in Japanese, making it suitable for workflows that use Japanese in titles, organization, and documentation.

When should I use path generation versus listing existing notes?▼

Use path generation when drafting new implementation plans or creating notes; use list when you need to review, reference, or navigate previously created notes without regenerating paths.