Skip to content

Bootstrap zettelkasten (smart notes) skill draft - #91

Open
alycda wants to merge 2 commits into
mainfrom
claude/zettelkasten-skill-draft-ibvjfl
Open

Bootstrap zettelkasten (smart notes) skill draft#91
alycda wants to merge 2 commits into
mainfrom
claude/zettelkasten-skill-draft-ibvjfl

Conversation

@alycda

@alycda alycda commented Aug 6, 2026

Copy link
Copy Markdown
Owner

What

Bootstraps a local zettelkasten agent skill (zettelkasten / How to Take Smart Notes workflow) as a best-effort draft, following the skill-creator writing guidance:

  • tools/agents/skills/zettelkasten/SKILL.md — frontmatter with a triggering-tuned description; core model (fleeting → literature → permanent notes); a 5-step processing workflow; note templates; copyright discipline; bibliography.
  • home-manager/modules/tools/agent-skills.nix — wires the skill into ~/.claude/skills/ via skillSource, alongside html-deck / jujutsu.

Copyright

Per the source-material policy in alycda/project#1 ("attribution does not grant reproduction rights"; "the record-not-the-work rule is the literature note"):

  • The skill contains original expression only — it describes the method in its own words and cites Ahrens (How to Take Smart Notes) and Luhmann ("Kommunikation mit Zettelkästen") bibliographically, reproducing no source text.
  • The same rule is baked into the skill's instructions: literature notes are own-words synthesis with references attached, never pasted source text; quotes only when the exact wording is the point, short, marked, and attributed.

Draft status

Deliberately loose — a locally-initialized version of this skill exists elsewhere on disk and will be merged in later. This draft keeps a lean single SKILL.md (no references/ sub-files yet), and skill-creator's eval/iteration loop hasn't been run on it. Both can happen once the on-disk version is found and folded in.


Generated by Claude Code

Add a local agent skill for the zettelkasten / How to Take Smart Notes
workflow: triage raw captures, restate sources as own-words literature
notes with references attached, distill atomic permanent notes, and link
them with stated reasons.

This is a deliberate best-effort bootstrap - a locally-initialized
version of this skill exists elsewhere on disk and will be merged in
later, so the draft favors a lean single SKILL.md over references/
sub-files for now.

The skill bakes in the source-material copyright policy from
alycda/project#1: attribution does not grant reproduction rights, so
notes record personal synthesis with bibliographic pointers, never
source text ("the record-not-the-work rule is the literature note").
The skill body itself follows the same rule - it describes the method
in original words and cites Ahrens/Luhmann bibliographically only.

Specific changes:
- tools/agents/skills/zettelkasten/SKILL.md: new skill (frontmatter
  description tuned for triggering per the skill-creator guidance,
  workflow, note templates, copyright discipline, bibliography)
- home-manager/modules/tools/agent-skills.nix: wire the skill into
  ~/.claude/skills/ via skillSource, alongside html-deck/jujutsu

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EneKrhLQfEihsFhgLrsNUb
@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

⊕ Entity-level changes

home-manager/modules/tools/agent-skills.nix

Status Type Name
Δ binding config

tools/agents/skills/zettelkasten/SKILL.md

Status Type Name
+ preamble (preamble)
+ heading Zettelkasten (Smart Notes)
+ heading Core model
+ heading Workflow
+ heading Note templates
+ heading — <Title>
+ heading
+ heading Copyright discipline (non-negotiable)
+ heading Sources

Summary: 9 added, 1 modified across 2 files

functions and classes, not lines · sem

@alycda
alycda marked this pull request as ready for review August 9, 2026 06:55
@alycda

alycda commented Aug 9, 2026

Copy link
Copy Markdown
Owner Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants