ai-notes

Manage AI notes in ~/Compost/AI-Notes - read existing notes, list recent documents, and write new implementation plans (仕様書, 計画書, 設計書). Auto-triggers when reading from or writing to notes, specifications, or plans.

16 stars

Best use case

ai-notes is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Manage AI notes in ~/Compost/AI-Notes - read existing notes, list recent documents, and write new implementation plans (仕様書, 計画書, 設計書). Auto-triggers when reading from or writing to notes, specifications, or plans.

Teams using ai-notes should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/ai-notes/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/devops/ai-notes/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/ai-notes/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How ai-notes Compares

Feature / Agentai-notesStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Manage AI notes in ~/Compost/AI-Notes - read existing notes, list recent documents, and write new implementation plans (仕様書, 計画書, 設計書). Auto-triggers when reading from or writing to notes, specifications, or plans.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

## Notes Management Script

**IMPORTANT**: Use the `notes.ts` script for all AI notes operations.

```bash
# Script location
~/.claude/skills/ai-notes/notes.ts
```

### Generate Output Path

Generate correct file paths for new notes:

```bash
# Single document
deno run -A ~/.claude/skills/ai-notes/notes.ts generate "<title>"
# => ~/Compost/AI-Notes/2025-12/24-0821-<title>.md

# Multiple documents (returns directory path)
deno run -A ~/.claude/skills/ai-notes/notes.ts generate "<title>" --multiple
# => ~/Compost/AI-Notes/2025-12/24-0821-<title>/
```

### List Existing Notes

List notes ordered by file path (newest first) with H1 titles:

```bash
# List all notes
deno run -A ~/.claude/skills/ai-notes/notes.ts list

# List 10 most recent notes
deno run -A ~/.claude/skills/ai-notes/notes.ts list --limit 10

# Pagination: skip first 10, show next 10
deno run -A ~/.claude/skills/ai-notes/notes.ts list --limit 10 --offset 10
```

**Output format**: Each line shows the full path and the first H1 heading from the file:
```
/path/to/note.md: タイトル
```

## Path Convention

- Base directory: `~/Compost/AI-Notes/{year}-{month}/`
- Single document: `{day}-{hour}{minutes}-{title}.md`
- Multiple documents: `{day}-{hour}{minutes}-{title}/{number}-{title}.md`

## Content Requirements

- **Language**: Write documents in Japanese
- **Code Comments**: ALWAYS write code comments in English, even when the document is in Japanese
  - Example code snippets should have English comments
  - Inline code documentation should be in English
  - Only narrative text outside code blocks should be in Japanese
- **Diagrams**: Use Mermaid syntax for all diagrams and flowcharts

## Reading Notes

When user requests reading from notes:

1. **List recent notes**: Use `notes.ts list --limit 20` to get recent documents
2. **Search by pattern**: Use Glob tool with pattern like `~/Compost/AI-Notes/**/*{keyword}*.md`
3. **Search by content**: Use Grep tool to search across note contents
4. **Complex searches**: Use Task tool with Explore agent for multi-step exploration

**Search priority**:
- Start with `notes.ts list` to see recent notes
- For specific topics, use Grep across `~/Compost/AI-Notes`
- For complex queries, delegate to Explore agent

Related Skills

android-release-notes-structure

16
from diegosouzapw/awesome-omni-skill

Create Play Store release notes directory structure with locale templates (Fastlane metadata)

update-notes

16
from diegosouzapw/awesome-omni-skill

Condense learnings from this session, so that they can be used to make better decisions on future runs. With these notes, you don't need to rely on auto-compaction to keep a conversation going.

team-collaboration-standup-notes

16
from diegosouzapw/awesome-omni-skill

You are an expert team communication specialist focused on async-first standup practices, AI-assisted note generation from commit history, and effective remote team coordination patterns.

langchain-notes

16
from diegosouzapw/awesome-omni-skill

LangChain 框架学习笔记 - 快速查找概念、代码示例和最佳实践。包含 Core components、Middleware、Advanced usage、Multi-agent patterns、RAG retrieval、Long-term memory 等主题。当用户询问 LangChain、Agent、RAG、向量存储、工具使用、记忆系统时使用此 Skill。

Meeting Notes Taker

16
from diegosouzapw/awesome-omni-skill

Summarize meetings into clear, actionable notes with decisions and next steps

apple-notes

16
from diegosouzapw/awesome-omni-skill

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, list notes, search notes, or manage note folders.

adding-notes

16
from diegosouzapw/awesome-omni-skill

Add new notes to the Second Brain knowledge base. Use when the user provides a resource (URL, book, podcast, article, GitHub repo, Reddit thread) and asks to "add a note", "create a note", "save this", "add to my notes", "take notes on", or "capture this".

bgo

10
from diegosouzapw/awesome-omni-skill

Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.

Coding & Development

ai-search-technical-auditor

16
from diegosouzapw/awesome-omni-skill

Audit front-end code for AI search readiness. Use when reviewing HTML structure, meta tags, schema markup, and technical elements that affect how AI crawlers understand and index web pages.

ai-output-validator

16
from diegosouzapw/awesome-omni-skill

AI出力の品質を自動検証するスキル。事実確認、論理性、一貫性、幻覚(ハルシネーション)検出、バイアス分析、安全性チェックを実施し、改善提案を提供。

ai-organizer-ui-consolidation

16
from diegosouzapw/awesome-omni-skill

Build a unified, ADHD-friendly web UI that consolidates 70+ CLI tools into a beautiful liquid glass interface for the AI File Organizer. Use when creating the complete frontend application that replaces all terminal interactions with a macOS-inspired dashboard for file organization, search, VEO prompts, and system management.

ai-image-asset-generator

16
from diegosouzapw/awesome-omni-skill

This skill should be used when generating AI image assets for websites, landing pages, or applications. It automatically analyzes page requirements, generates images using Gemini API, removes backgrounds, converts to SVG for interactivity, and places assets in frontend code. Ideal for creating hero images, icons, backgrounds, product mockups, and infographic elements. Use this skill when users need image assets for their web projects.