How do I install the Secondbrain Note skill?

Run npx skillmds@latest add sergio-bershadsky/secondbrain-note in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Secondbrain Note safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Secondbrain Note?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Secondbrain Note free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Secondbrain Note?

sergio-bershadsky (@sergio-bershadsky) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Secondbrain Note by sergio-bershadsky

Name: Secondbrain Note
Author: sergio-bershadsky

Secondbrain Note

This skill should be used when the user asks to "create note", "capture thought", "save this", "document idea", "write note", "jot down", "quick note", "remember this", "capture this", or mentions wanting to save knowledge, ideas, or learnings for later reference in their secondbrain.

sergio-bershadsky 5288179 2 files · 6.8 KB Updated Sep 17, 2026

File contents

Create Note

Capture knowledge, ideas, and thoughts with tagging support.

Prerequisites

Verify Notes entity is enabled:

Check for .claude/data/notes/meta.yaml (sharded) or .claude/data/notes/records.yaml (legacy)
If not found, suggest enabling notes via secondbrain-init or secondbrain-entity

Workflow

Step 1: Gather Information

Collect from user or conversation context:

Title — Brief, descriptive title
Content — Main content (can be from conversation)
Tags (optional) — Categorization tags

Step 2: Generate Note ID

Date-based ID format: YYYY-MM-DD-<title-slug>

Example: 2026-01-15-kubernetes-deployment-patterns

Step 3: Create Note Document

Filename: docs/notes/YYYY-MM-DD-<slug>.md

Frontmatter:

---
id: 2026-01-15-my-note
title: My Note Title
created: 2026-01-15
tags: [tag1, tag2]
status: active
---

Content:

# My Note Title

## Summary

Brief overview...

## Content

Main content here...

## References

- Links to related resources

## Related

- Links to related notes, ADRs, etc.

Step 4: Update Records

Add entry to the current month's shard .claude/data/notes/YYYY-MM.yaml:

- id: "2026-01-15-my-note"
  title: "My Note Title"
  created: 2026-01-15
  file: docs/notes/2026-01-15-my-note.md
  tags: [tag1, tag2]
  status: active

Ensure the current month is registered in .claude/data/notes/meta.yaml shards list.

Step 5: Sidebar Note

DO NOT manually add notes to VitePress sidebar.

Notes are automatically listed via the EntityTable component on docs/notes/index.md, which reads from .claude/data/notes/ shard files. No sidebar modification needed.

Step 6: Confirm Creation

## Note Created

**ID:** 2026-01-15-kubernetes-deployment-patterns
**Title:** Kubernetes Deployment Patterns
**Tags:** kubernetes, deployment, devops
**File:** docs/notes/2026-01-15-kubernetes-deployment-patterns.md

The note has been created and is ready for editing.

Category	Example Tags
Technology	`kubernetes`, `react`, `python`
Domain	`architecture`, `security`, `performance`
Type	`howto`, `reference`, `research`
Project	`project-x`, `migration`, `refactor`

Status Values

active — Current, relevant note
archived — No longer current but preserved

Additional Resources

references/note-formats.md — Detailed note templates and formatting patterns

Tips

Be specific — Titles should indicate content at a glance
Add context — Include why this is important, not just what
Link liberally — Connect to related notes and external resources
Tag consistently — Use established tags when possible
Review periodically — Archive notes that are no longer relevant

---name: secondbrain-notedescription: This skill should be used when the user asks to "create note", "capture thought", "save this", "document idea", "write note", "jot down", "quick note", "remember this", "capture this", or mentions wanting to save knowledge, ideas, or learnings for later reference in their secondbrain.---# Create NoteCapture knowledge, ideas, and thoughts with tagging support.## PrerequisitesVerify Notes entity is enabled:1. Check for `.claude/data/notes/meta.yaml` (sharded) or `.claude/data/notes/records.yaml` (legacy)2. If not found, suggest enabling notes via `secondbrain-init` or `secondbrain-entity`## Workflow### Step 1: Gather InformationCollect from user or conversation context:1. **Title** — Brief, descriptive title2. **Content** — Main content (can be from conversation)3. **Tags** (optional) — Categorization tags### Step 2: Generate Note IDDate-based ID format: `YYYY-MM-DD-<title-slug>`Example: `2026-01-15-kubernetes-deployment-patterns`### Step 3: Create Note Document**Filename:** `docs/notes/YYYY-MM-DD-<slug>.md`**Frontmatter:**```yaml---id: 2026-01-15-my-notetitle: My Note Titlecreated: 2026-01-15tags: [tag1, tag2]status: active---```**Content:**```markdown# My Note Title## SummaryBrief overview...## ContentMain content here...## References- Links to related resources## Related- Links to related notes, ADRs, etc.```### Step 4: Update RecordsAdd entry to the current month's shard `.claude/data/notes/YYYY-MM.yaml`:```yaml- id: "2026-01-15-my-note" title: "My Note Title" created: 2026-01-15 file: docs/notes/2026-01-15-my-note.md tags: [tag1, tag2] status: active```Ensure the current month is registered in `.claude/data/notes/meta.yaml` shards list.### Step 5: Sidebar Note**DO NOT manually add notes to VitePress sidebar.**Notes are automatically listed via the `EntityTable` component on `docs/notes/index.md`, which reads from `.claude/data/notes/` shard files. No sidebar modification needed.### Step 6: Confirm Creation```## Note Created**ID:** 2026-01-15-kubernetes-deployment-patterns**Title:** Kubernetes Deployment Patterns**Tags:** kubernetes, deployment, devops**File:** docs/notes/2026-01-15-kubernetes-deployment-patterns.mdThe note has been created and is ready for editing.```## TagsTags help organize notes for discovery. Common patterns:| Category | Example Tags ||----------|--------------|| Technology | `kubernetes`, `react`, `python` || Domain | `architecture`, `security`, `performance` || Type | `howto`, `reference`, `research` || Project | `project-x`, `migration`, `refactor` |## Status Values- `active` — Current, relevant note- `archived` — No longer current but preserved## Additional Resources- **`references/note-formats.md`** — Detailed note templates and formatting patterns## Tips1. **Be specific** — Titles should indicate content at a glance2. **Add context** — Include why this is important, not just what3. **Link liberally** — Connect to related notes and external resources4. **Tag consistently** — Use established tags when possible5. **Review periodically** — Archive notes that are no longer relevant

Frequently asked questions