skills.rest
yizhitangtongxue
yizhitangtongxueCOMMUNITY
Explore all skills by this author →
GitHub

record-session

Records work sessions and archives completed tasks in Trellis project journals.

Updated Mar 24, 2026
Search Tags:#git#workflow automation#python#session recording#trellis#task archiving#project journal
One-click install
npx skills add https://github.com/yizhitangtongxue/opencode-switch --skill record-session-yizhitangtongxue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: record-session
Source: https://github.com/yizhitangtongxue/opencode-switch/tree/main/.agents/skills/record-session
Command: npx skills add https://github.com/yizhitangtongxue/opencode-switch --skill record-session-yizhitangtongxue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After code is tested and committed, developers often forget to document what was done, leaving project history incomplete. This Skill automates recording work sessions into Trellis journals and archiving finished tasks so project context stays accurate. ## Core Features & Use Cases - One-Click Session Logging: Appends a titled session with commit hashes and summaries to journal files, automatically splitting files that exceed 2000 lines. - Task Archiving: Archives tasks whose work is actually done based on commit status rather than stale status fields. - Automatic Index Maintenance: Updates index.md with session counts, last-active timestamps, and history, then auto-commits .trellis changes. - Use Case: After merging a feature branch, run the record workflow to log the session with its commit hashes and archive the corresponding task in one pass. ## Quick Start Record a work session titled with the feature name, including the recent commit hashes and a summary of the changes made.

Frequently Asked Questions about record-session

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

FAQPage Schema
How do I record a work session in Trellis after committing code?▼

Run add_session.py with --title, --commit, and --summary parameters, or pipe detailed markdown content via stdin. The script appends the session to the journal, updates index.md, and auto-commits the .trellis changes.

How do I archive a completed task in Trellis?▼

Run task.py archive with the task name after verifying the work is actually done. Judge completion by committed code and met acceptance criteria, not by the status field in task.json, and the script auto-commits the change.

Should I run git commit manually when recording sessions?▼

No, the scripts handle their own commits for .trellis metadata automatically. You only need read-only git commands like git log, git status, and git diff to gather context.

When should the record-session workflow be used?▼

Use it only after the human has tested and committed the code. Running it before commits exist means there are no commit hashes to reference and the recorded session would not reflect verified work.

What happens when a Trellis journal file gets too large?▼

The add_session script detects the line count automatically and creates a new journal file when the current one exceeds 2000 lines, keeping the index updated with line statistics.

Related Skills

Explore More Software Engineering Skills→
ze-softwareze-software
50

Scoped Commit

Generate a commit script that enforces explicit scope verification before recording changes.

Official
Intermediate
Kestral-TeamKestral-Team
4

kestral-end-day-review

Synthesize daily progress from Kestral, GitHub, and local history into end-of-day reports.

Official
Advanced
LonelyHerbivoreLonelyHerbivore
92

record-session

Records completed human-verified work into Trellis workspace journal files and updates session indexes.

Community
Intermediate
daniel-heydari-devdaniel-heydari-dev

changelog-generation

Generate changelogs and enforce semantic versioning from conventional commits.

Community
Intermediate