skills.rest
jl-cmd
jl-cmdCOMMUNITY
Explore all skills by this author →
GitHub

session-log

Generates HTML session reports with frontmatter metadata and publishes them to an Obsidian vault.

6|1|Updated Jul 11, 2026
Search Tags:#documentation#session logging#artifact publishing#Obsidian vault#HTML report#decision extraction#frontmatter metadata
One-click install
npx skills add https://github.com/jl-cmd/claude-dev-env --skill session-log-jl-cmd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-log
Source: https://github.com/jl-cmd/claude-dev-env/tree/main/skill-archive/session-log
Command: npx skills add https://github.com/jl-cmd/claude-dev-env --skill session-log-jl-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a completed work session into a durable, searchable HTML report stored in a vault, so decisions, outcomes, and context are not lost when the conversation ends. ## Core Features & Use Cases - HTML Report Composition and Publishing: Designs a session-character-appropriate page (PR writeup, timeline, decision record) and publishes it via the Artifact tool with a fixed favicon. - Vault Metadata Tracking: Writes a frontmatter contract (project, session number, session_id, status, vault_context_retrieved) into every report and auto-numbers sessions per project folder. - Decision Extraction and Tidy: Prompts to save unrecorded decisions via /remember, audits the project's session folder for naming and frontmatter issues, and copies a /rename command to the clipboard. - Use Case: After finishing a multi-hour debugging session, run /session-log to produce a numbered HTML report in your Obsidian vault that a cold reader can understand from the section headers alone. ## Quick Start Ask the assistant to log this session as a session report in the vault.

Frequently Asked Questions about session-log

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I log a work session as an HTML report?▼

Invoke /session-log or ask to journal the session. The skill composes a self-contained HTML page, writes it to the vault's sessions folder with an auto-incremented number, and publishes it through the Artifact tool.

What metadata does a session report include?▼

Each report carries an HTML-comment frontmatter block with type, project, session number, session_id from CLAUDE_CODE_SESSION_ID, date, status, blocked flag, vault_context_retrieved flag, and tags. This enables vault search and later tidy audits.

Does session-log work without an Obsidian vault?▼

Yes. It first checks for the obsidian-headless CLI and OBSIDIAN_VAULT_PATH, then falls back to a local vault at ~/.claude/vault/, creating the sessions directory if missing. Reports are HTML regardless of backend.

Why does republishing a session report mint a new URL?▼

The Artifact tool redeploys to the same URL only within the current run. A fresh session has no memory of an earlier artifact URL, so republishing a report written in a prior run always creates a new URL.

Can Obsidian search session reports by frontmatter fields?▼

No. Obsidian's native YAML-frontmatter parser reads only .md files, so HTML reports do not appear in the frontmatter index. Content search still works, but queries like type: session-report do not.

Related Skills

Explore More Software Engineering Skills→
DxTaDxTa

sia-code/decision-trace

Record AI decisions with context, alternatives, and outcomes in sia-code memory.

Community
Intermediate
jackneiljackneil
1

jacked

Search past Claude Code sessions and load selected context to resume work.

Community
Advanced
joshka0joshka0
3

Remember

Save key learnings, decisions, and gotchas into foxctl memory with typed classification.

Community
Basic
devkadedevkade
2

pkm:daily-setup

Generate and update Obsidian daily journal entries from templates with YAML frontmatter and pomodoro tracking.

Community
Intermediate