home / skills / jinfanzheng / kode-sdk-csharp / knowledge

knowledge skill

/examples/Kode.Agent.WebApiAssistant/skills/knowledge

This skill helps you save notes, bookmarks, and code snippets for later access by organizing them into structured destinations.

npx playbooks add skill jinfanzheng/kode-sdk-csharp --skill knowledge

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.8 KB

---
name: knowledge
description: External knowledge capture and retrieval. Trigger when user wants to save notes, bookmarks, code snippets, or reference material for later access.
---

## Mental Model

Knowledge is for **deliberate capture of reference material**. Unlike memory (which extracts info from conversation), knowledge is explicit: user asks to save something.

## Trigger Patterns

| User Intent | Action | Destination |
|-------------|--------|-------------|
| "Save this link" | Store URL | `bookmarks.jsonl` |
| "Make a note about X" | Create note | `notes/YYYY-MM-DD_topic.md` |
| "Remember this code pattern" | Save snippet | `snippets/{lang}/` |

## What Goes Where

```
.knowledge/
├── bookmarks.jsonl           # URLs, articles, docs
├── notes/
│   └── YYYY-MM-DD_topic.md   # Meeting notes, ideas, summaries
└── snippets/
    ├── typescript/           # Language-specific patterns
    ├── python/
    └── shell/
```

## Entry Schemas

**Bookmark:**
```json
{"id":"bm_{{timestamp}}","url":"{{URL}}","title":"{{page title}}","tags":["{{keywords}}"],"savedAt":"{{ISO8601}}"}
```

**Note (Markdown + YAML):**
```markdown
---
title: {{Topic}}
date: {{YYYY-MM-DD}}
tags: [{{keywords}}]
---

# {{Topic}}

{{content}}
```

**Snippet:**
```typescript
// @title: {{Pattern Name}}
// @tags: {{keyword1}}, {{keyword2}}
// @created: {{YYYY-MM-DD}}

{{code}}
```

## Anti-Patterns (NEVER)

- Don't save transient information (today's weather, temporary URLs)
- Don't duplicate - check if already exists before saving
- Don't save without user's explicit request (use `memory` skill for that)

## Action Pattern

User says "保存这个链接" or "Save this":
1. Extract URL, title, context
2. Generate relevant tags
3. `fs_write` to appropriate destination
4. Confirm what was saved

Overview

This skill captures and retrieves external knowledge items like notes, bookmarks, and code snippets for later reference. It stores entries in a predictable file structure and enforces clear schemas so saved items are easy to search and reuse. Use it when the user explicitly asks to save or bookmark content.

How this skill works

When triggered by an explicit save request, the skill extracts the key elements (URL, title, tags, code, or note content) and normalizes metadata (timestamps, tags). It chooses the destination based on content type (bookmarks.jsonl, notes/YYYY-MM-DD_topic.md, or snippets/{lang}/) and writes a structured entry using the defined schema. The skill checks for duplicates, avoids transient data, and returns a concise confirmation of what was saved and where.

When to use it

User asks to save a link or article for later reading
User requests creating a meeting note, idea, or summary
User wants to store a reusable code pattern or snippet
User asks to bookmark documentation or reference material
When organizing reference items into tags and dated notes

Best practices

Only save content on explicit user request; do not auto-capture conversation details
Generate meaningful tags and titles to make retrieval efficient
Check existing entries to avoid duplicates before writing
Store notes as Markdown with YAML front matter for easy parsing
Keep snippets organized by language and include metadata comments

Example use cases

Save an article URL and title to bookmarks.jsonl with generated tags
Create a dated meeting note file notes/2026-02-16_design-review.md with YAML header
Store a Python utility pattern under snippets/python/ with @title and @tags in a header comment
Bookmark API docs for later code reference and link them to related snippets
Collect interview takeaways as structured notes for future retrieval

FAQ

Will the skill save transient items like weather or one-time tokens?

No. The skill avoids saving transient or sensitive data and requires explicit user intent to store information.

How does duplicate detection work?

Before writing, the skill checks existing entries by URL, title, or snippet checksum and prompts or skips if a match exists.

Can I control where a note is saved or its filename?

Yes. The skill generates sensible filenames but will accept user-specified titles or topics to form the date-prefixed Markdown filename.