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.