mcpbeat

Xs Note Taking

karaage0703/xs-note-taking

notes/ディレクトリへのメモ保存スキル。調査結果、企画、アイデア、会議メモなどを保存する時に使用。「メモして」「ノートにまとめて」「notesに保存」「notesにまとめて」「まとめておいて」で発動。「最近のメモ教えて」「メモの内容教えて」でメモ一覧・内容確認も可能。

1k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
136
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/karaage0703/ai-assistant-workspace --skill xs-note-taking

The instruction itself

8 sections, as written by the author

notes/ 管理スキル

調査結果・企画・アイデア・会議メモなどを notes/ に保存・確認する。

保存先

ワークスペースの notes/ ディレクトリ


基本方針

  • ファイルに保存してから「保存した」と報告する
  • 保存先のパスを必ず報告する
  • 後で再利用したい内容は notes/、その日の生ログは memory/ に残す
  • 調査結果、企画、レビュー、会議メモは、検索しやすいタイトルとタグを付ける
  • 個人情報、トークン、秘密情報を公開リポジトリに入れない
  • Git管理している場合、commit / push が必要かはユーザーの運用ルールに従う

メモの確認

「最近のメモ教えて」「メモの内容教えて」で発動。

最近のメモ一覧を表示

# 最新10件を表示
ls -lt notes/*.md | head -10

報告フォーマット

最近のメモ(直近10件)

1. Claude_Code調査メモ (2/1)
2. プロジェクト企画 (2/1)
3. 会議メモ (1/31)

番号で指定してくれたら内容見せるよ!

特定のメモの内容を確認

ユーザーが指定したメモを読み、要約または全文を提示。


ファイル命名規則(必須!)

YYYYMMDD_タイトル.md

例:

  • 20260201_プロジェクト企画.md
  • 20260201_会議メモ.md
  • 20260201_Claude_MCP調査.md

重要

  • 日付は必ず今日の日付date +%Y%m%d で取得)
  • 日付プレフィックスなしは NG
  • タイトルは日本語 OK

フロントマター(推奨)

---
title: ノートのタイトル
date: YYYY-MM-DD
type: memo  # memo, idea, plan, review, research, meeting, prompt, presentation
tags:
  - タグ1
  - タグ2
status: draft  # draft, in-progress, completed
---

type の種類

| type | 用途 |

|------|------|

| memo | 日々のメモ、気づき |

| idea | アイデア、ひらめき |

| plan | 企画、計画 |

| research | 調査結果 |

| review | レビュー、分析 |

| meeting | 会議メモ |

| prompt | プロンプト関連 |

| presentation | プレゼン資料 |

保存手順

Step 1: 日付を取得

date +%Y%m%d
# → 20260201

Step 2: ファイル作成

notes/YYYYMMDD_タイトル.md にファイルを作成。

Step 3: 保存後の確認

git diff -- notes/YYYYMMDD_タイトル.md

確認すること:

  • 日付プレフィックスがあるか
  • 内容が後から読める粒度か
  • private な値が混ざっていないか
  • MarkdownリンクがGitHubでも読める形式か

Step 4: 同期(Git管理の場合)

git add notes/ && git commit -m "メモ追加: タイトル" && git push

公開リポジトリや共有リポジトリへ push する場合は、実行前に対象操作をユーザーへ確認する。

Step 5: RAG更新(任意)

workspace-RAG を使っている場合、保存後にインデックス更新すると次回以降の検索に出る。

curl -s -X POST "http://127.0.0.1:7890/reindex"

サーバーが動いていない場合は省略してよい。省略した場合は報告に「RAG再インデックスは未実施」と書く。

リンク形式

GitHub上でもリンクが機能するMarkdown形式を使用:

# 推奨(GitHub対応)
[表示名](YYYYMMDD_ファイル名.md)

# 非推奨(Obsidian専用)
[[ファイル名]]

notes/ vs memory/ の使い分け

| 場所 | 用途 | 例 |

|------|------|-----|

| notes/ | アウトプット向け、まとまった内容 | 調査結果、企画、日記、レビュー |

| memory/ | 内部ログ、会話記録 | その日やったこと、調べたこと |

迷ったら:

  • 「後で見返したい、他で使いたい」→ notes/
  • 「今日の作業記録」→ memory/
  • 「行動ルールとして毎回効かせたい」→ AGENTS.md
  • 「長期的な好み・環境・継続案件」→ MEMORY.md

チェックリスト

保存前に確認:

  • [ ] ファイル名が YYYYMMDD_タイトル.md 形式か
  • [ ] 日付は今日の日付か
  • [ ] フロントマターを付けたか(推奨)
  • [ ] リンクはGitHub対応形式か
  • [ ] 完了報告にファイルパスを含めたか
  • [ ] private な値や外部公開してはいけない情報が入っていないか
  • [ ] RAG再インデックスが必要か判断したか

How to use it

Copy the folder

Take karaage0703/xs-note-taking from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.