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.
How do I install this agent skill?
npx skills add https://github.com/sergio-bershadsky/ai --skill secondbrain-noteIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a benign note-taking utility designed to capture user thoughts, ideas, and conversation context into structured markdown files. It follows standard practices for knowledge management and does not exhibit any malicious behavior.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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-initorsecondbrain-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.
Tags
Tags 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 notearchived— 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sergio-bershadsky/ai/secondbrain-note">View secondbrain-note on skillZs</a>