Index of every page on this site: llms.txt
All skills
makenotion avatar

/knowledge-capture

@016c74f official
Run it yourself

Captures conversations and supplied notes as Notion wiki pages, how-to guides, FAQs, decision records, or retrospectives. Use when saving or updating durable knowledge from existing context; use research-documentation when new source discovery and synthesis is the main task.

  • 18 files
  • 50.2 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/makenotion/claude-code-notion-plugin/knowledge-capture

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencedatabase-best-practices.md

≈837 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Database Best Practices

Use these design examples when creating or adapting a database is requested. For an existing database, use its actual schema and conventions; do not add properties, views, or a new database merely to match an example. Tool arguments below are illustrative; follow the exposed tool schema.

Core Principles

1. Keep It Simple

  • Start with core properties
  • Add more only when needed
  • Don't over-engineer

2. Use Consistent Naming

  • Title property for main identifier
  • Status for lifecycle tracking
  • Tags for flexible categorization
  • Owner for accountability

3. Include Metadata

  • Created/Updated timestamps
  • Owner or maintainer
  • Last reviewed dates
  • Status indicators

4. Enable Discovery

  • Use tags liberally
  • Create helpful views
  • Link related content
  • Use clear titles

5. Plan for Scale

  • Consider filters early
  • Use relations for connections
  • Think about search
  • Organize with categories

Creating a Database

Using Notion:notion-create-database

Example for documentation database:

{
  "parent": {"page_id": "wiki-page-id"},
  "title": [{"text": {"content": "Team Documentation"}}],
  "properties": {
    "Type": {
      "select": {
        "options": [
          {"name": "How-To", "color": "blue"},
          {"name": "Concept", "color": "green"},
          {"name": "Reference", "color": "gray"},
          {"name": "FAQ", "color": "yellow"}
        ]
      }
    },
    "Category": {
      "select": {
        "options": [
          {"name": "Engineering", "color": "red"},
          {"name": "Product", "color": "purple"},
          {"name": "Design", "color": "pink"}
        ]
      }
    },
    "Tags": {"multi_select": {"options": []}},
    "Owner": {"people": {}},
    "Status": {
      "select": {
        "options": [
          {"name": "Draft", "color": "gray"},
          {"name": "Final", "color": "green"},
          {"name": "Deprecated", "color": "red"}
        ]
      }
    }
  }
}

Fetching Database Schema

Before creating database items, fetch the schema unless a current copy is already available in this task:

Notion:notion-fetch
id: "database-url-or-id"

This returns the exact property names and types to use.

Database Selection Guide

Need Use This Database
General documentation Documentation Database
Track decisions Decision Log
Q&A knowledge base FAQ Database
Team-specific content Team Wiki
Step-by-step guides How-To Guide Database
Incident/project learnings Learning Database

Tips

  1. Start with general documentation database - most flexible
  2. Add specialized databases as needs emerge (FAQ, Decisions)
  3. Use relations to connect related docs
  4. Create views for common use cases
  5. Review properties quarterly - remove unused ones
  6. Document the schema in database description
  7. Train team on property usage and conventions

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 016c74f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 2 weeks ago

README badge

README badge for makenotion/claude-code-notion-plugin/knowledge-capture