save-session
Save a dated Obsidian recap of the current agent session, including outcomes, decisions, useful examples, changed files, and deferred work.
Install
npx skills add https://github.com/kriscard/Skills/tree/main/skills/obsidian/save-session
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kriscard-skills@llmmart
git clone https://github.com/kriscard/Skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kriscard/skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Save Session
Preserve what happened in this session so the user can resume or understand it later. This is a dated
record, not an Atomic Note and not a replacement for the issue tracker. Use create-note separately
when a lesson deserves reusable Knowledge.
1. Establish the evidence
Read ../vault/SKILL.md and the live AGENTS.md. Review the available conversation and its tool
results. Incorporate supplied context without treating a request or attempted action as a completed
result. If history was compacted or unavailable, state the coverage limit.
Collect outcomes, decisions and reasons, useful examples, changed files, verification results, and work deliberately deferred. Separate pre-existing changes from work performed in this session. Exclude credentials, secrets, and unnecessary personal or workplace data.
Completion: every claimed outcome has session evidence; failures and unverified work remain explicit.
2. Resolve the session note
Use the real local date, a short descriptive title, and the schema-defined session directory. Inspect any existing note with the same title/date. Ask before updating it; otherwise choose a distinct path. Never overwrite a previous session merely because it happened on the same day.
Read a live session template if one exists. Otherwise use this outline with the session metadata required by the schema:
# Session title
## Summary
What this session was about and how it ended.
## What was done
Verified actions and outcomes.
## Decisions
What was chosen, why, and relevant alternatives.
## Useful examples
Commands, code, or explanations worth keeping.
## Changed files
Paths and the purpose of each session change.
## Deferred work
Unfinished work, known limitations, and questions left open.
Omit sections without evidence. Account for every known session-changed file, grouping repetitive paths only when the complete file list remains available in a linked receipt. Include useful detail without dumping the transcript or raw tool output. Keep planned and completed work distinct.
Completion: the path is collision-safe and the draft records both outcomes and remaining work.
3. Preview, save, and verify
Show the complete note and required log entry for approval. Write through the vault safe-write flow, reread the note, and verify metadata, links, and the approved log append. Report partial failures.
Keep daily notes unchanged. The inspiration's automatic daily append is not part of this vault's
permissions. Session records do not need wiki-index entries; offer a separate create-note proposal
for reusable explanations or questions, without creating them as a side effect.
Completion: the approved recap and log entry exist, no unrelated note changed, and the saved path plus any useful Knowledge candidates are reported.
Design source
Adapted from Fred Oliveira's done skill: retain decisions, examples, changed files, and deferred work. Use this vault's paths, ownership, approval, and safe-write rules rather than copying its shell writes or daily-note append.
Files (skills)
-
SKILL.md 3.3 KB
--- name: save-session description: Save a dated Obsidian recap of the current agent session, including outcomes, decisions, useful examples, changed files, and deferred work. disable-model-invocation: true argument-hint: '[optional context or session title]' --- # Save Session Preserve what happened in this session so the user can resume or understand it later. This is a dated record, not an Atomic Note and not a replacement for the issue tracker. Use `create-note` separately when a lesson deserves reusable Knowledge. ## 1. Establish the evidence Read `../vault/SKILL.md` and the live `AGENTS.md`. Review the available conversation and its tool results. Incorporate supplied context without treating a request or attempted action as a completed result. If history was compacted or unavailable, state the coverage limit. Collect outcomes, decisions and reasons, useful examples, changed files, verification results, and work deliberately deferred. Separate pre-existing changes from work performed in this session. Exclude credentials, secrets, and unnecessary personal or workplace data. Completion: every claimed outcome has session evidence; failures and unverified work remain explicit. ## 2. Resolve the session note Use the real local date, a short descriptive title, and the schema-defined session directory. Inspect any existing note with the same title/date. Ask before updating it; otherwise choose a distinct path. Never overwrite a previous session merely because it happened on the same day. Read a live session template if one exists. Otherwise use this outline with the session metadata required by the schema: ```markdown # Session title ## Summary What this session was about and how it ended. ## What was done Verified actions and outcomes. ## Decisions What was chosen, why, and relevant alternatives. ## Useful examples Commands, code, or explanations worth keeping. ## Changed files Paths and the purpose of each session change. ## Deferred work Unfinished work, known limitations, and questions left open. ``` Omit sections without evidence. Account for every known session-changed file, grouping repetitive paths only when the complete file list remains available in a linked receipt. Include useful detail without dumping the transcript or raw tool output. Keep planned and completed work distinct. Completion: the path is collision-safe and the draft records both outcomes and remaining work. ## 3. Preview, save, and verify Show the complete note and required log entry for approval. Write through the vault safe-write flow, reread the note, and verify metadata, links, and the approved log append. Report partial failures. Keep daily notes unchanged. The inspiration's automatic daily append is not part of this vault's permissions. Session records do not need wiki-index entries; offer a separate `create-note` proposal for reusable explanations or questions, without creating them as a side effect. Completion: the approved recap and log entry exist, no unrelated note changed, and the saved path plus any useful Knowledge candidates are reported. ## Design source Adapted from [Fred Oliveira's done skill](https://github.com/fredoliveira/agents/blob/main/skills/done/SKILL.md): retain decisions, examples, changed files, and deferred work. Use this vault's paths, ownership, approval, and safe-write rules rather than copying its shell writes or daily-note append.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.