trellis-finish-work

Archives completed tasks and records session journals after verifying a clean git working tree.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/elebirds/panoptes --skill trellis-finish-work-elebirds
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-finish-work
Source: https://github.com/elebirds/panoptes/tree/main/.agents/skills/trellis-finish-work
Command: npx skills add https://github.com/elebirds/panoptes --skill trellis-finish-work-elebirds

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ending a coding session involves several easy-to-forget bookkeeping steps: confirming the quality gate passed, ensuring all work is committed, archiving finished tasks, and writing a session journal entry. This Skill standardizes that wrap-up so project history stays consistent and no completed task is left unarchived. ## Core Features & Use Cases - State survey: Runs get_context.py in record mode to list active tasks, git status, and recent commits, surfacing other completed tasks for optional batch archiving. - Clean-tree safety check: Verifies git status is clean (excluding .trellis/workspace and .trellis/tasks paths) and stops with a clear message if uncommitted code remains, directing the user back to the commit phase. - Task archiving and journaling: Archives the active task via task.py (producing chore(task) commits) and records a session journal with add_session.py, linking work commit hashes to a title and summary. - Use Case: After finishing a feature and committing the code, invoke this Skill to archive the task, log the session with its commit hashes, and leave the repository in a clean, well-documented state. ## Quick Start Ask the AI to finish the work session by archiving the current task and recording the session journal with the recent commit hashes.

Frequently Asked Questions about trellis-finish-work

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

FAQPage Schema
How do I archive a completed task in a Trellis workflow?▼

Run python3 ./.trellis/scripts/task.py archive <task-name> for each finished task. Each archive produces a chore(task): archive commit automatically via the script's auto-commit behavior.

How do I record a session journal with commit hashes?▼

Run add_session.py with --title, --commit, and --summary flags, passing the work commit hashes from the session as a comma-separated list. This creates a chore: record journal commit after the archive commits.

Why does the finish-work step stop with a dirty working tree error?▼

The skill requires a clean git status outside .trellis/workspace and .trellis/tasks before proceeding. Uncommitted code changes mean you must return to the commit phase first; the skill never commits code itself.

Does this skill create git commits for my code changes?▼

No. Code commits happen earlier in the workflow before this skill runs. It only produces chore(task): archive commits and a chore: record journal commit through the Trellis scripts.

Can I archive multiple completed tasks in one session wrap-up?▼

Yes. The state survey lists other completed-but-unarchived tasks, and with user confirmation they are archived alongside the current active task in the same round, each generating its own archive commit.