Agent skill
session-end
End Claude Code session with Beads sync and summary. MUST BE USED when user says they're done, ending session, or logging off. Guarantees Beads export to git, shows session stats, and suggests next ready work. Handles cleanup and context saving. Use when user says "goodbye", "bye", "done for now", "logging off", or when user mentions end-of-session, session termination, cleanup, context saving, bd sync, or export operations.
Install this agent skill to your Project
npx add-skill https://github.com/stars-end/agent-skills/tree/master/session-end
SKILL.md
Session End
End session cleanly with Beads export, stats, and next work suggestion.
Workflow
1. Set Beads Context
mcp__plugin_beads_beads__set_context(workspace_root="/path/to/project")
2. Force Beads Sync
CRITICAL: Beads auto-sync has 30s debounce. Session end requires explicit sync.
bd sync
What this does:
- Exports all changes to
.beads/issues.jsonl - Commits changes to git
- Pushes to remote (if configured)
- Guarantees persistence across sessions
3. Get Session Stats
stats = mcp__plugin_beads_beads__stats()
Show relevant metrics:
- Issues closed this session
- Issues created this session
- Current epic progress
- Total ready work available
4. Suggest Next Work
readyTasks = mcp__plugin_beads_beads__ready(priority=1)
Show top 3-5 ready tasks by priority:
- Unblocked P1 issues
- Next phase tasks in current epic
- High-value backlog items
5. Context Summary
Show what to resume in next session:
📊 Session Summary
Issues Closed: 3
• bd-xpi.4 (Testing)
• bd-xpi.4.1 (Bug: SessionStart permission)
• bd-xpi.4.2 (Bug: UserPromptSubmit JSON)
Issues Created: 2
• bd-xpi.4.1 (discovered-from bd-xpi.4)
• bd-xpi.4.2 (discovered-from bd-xpi.4)
Current Work:
bd-xpi.5 (in_progress): Implementation Part 2
Epic: bd-xpi (DX_V3_BEADS_INTEGRATION)
✅ Beads synced to git
📍 Next Session:
Top ready tasks:
1. bd-xpi.5 (P1) - Continue implementation
2. bd-abc.3 (P1) - API integration testing
3. bd-def.2 (P2) - Documentation updates
Say "bd ready" to see full ready work queue
Best Practices
- Always call at session end - Guarantees Beads persistence
- Don't skip sync - Auto-sync may not fire before session terminates
- Review stats - Understand what was accomplished
- Note next work - Reduces context switching overhead in next session
- Git status clean - Commit all work before session-end
Common Usage
User signals:
- "I'm done for today"
- "Ending session"
- "Log off"
- "Save and exit"
- "That's all for now"
Skill auto-detects these phrases via skill-rules.json patterns.
What This DOESN'T Do
- ❌ Create new issues (use beads-workflow for that)
- ❌ Commit code (use sync-feature-branch first)
- ❌ Close ongoing work (only syncs state)
Philosophy: Clean exits + Context preservation + Ready for next session
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
stars-end/agent-skills
toolchain-health
Validate Python toolchain alignment between mise, Poetry, and pyproject. Use when changing Python versions, editing pyproject.toml, or seeing Poetry/mise version solver errors. Invokes /toolchain-health to check: - .mise.toml python tool version - pyproject.toml python constraint - Poetry env python interpreter Keywords: python version, mise, poetry, toolchain, env use, lock, install
stars-end/agent-skills
parallelize-cloud-work
Delegate independent work to Claude Code Web cloud sessions for parallel execution. Generates comprehensive session prompts with context exploration guidance, verifies Beads state, provides tracking commands. Use when user says "parallelize work to cloud", "start cloud sessions", or needs to execute multiple independent tasks simultaneously, or when user mentions cloud sessions, cloud prompts, delegate to cloud, Claude Code Web, generate session prompts, parallel execution, or asks "how do I use cloud sessions".
stars-end/agent-skills
docs-create
Create epic-specific documentation skill with external reference docs. MUST BE USED for caching external docs. Fetches URLs, caches full content, uses documentation-engineer to generate cohesive summaries, and creates auto-activating skill. Use when starting work on epic that requires external documentation context (API docs, tool guides, reference materials), or when user mentions "cache docs", "external docs", "API documentation", URLs for docs, documentation needs, reference materials, knowledge caching, or epic context documentation.
stars-end/agent-skills
railway-doctor
stars-end/agent-skills
git-safety-guard
Installs a Git safety guard hook for Claude Code to prevent destructive Git and filesystem commands. Blocks accidental data loss from commands like 'git checkout --', 'git reset --hard', 'git clean -f', 'git push --force', and 'rm -rf'. Use this skill to set up safety rails in a new or existing repository, or globally for the agent.
stars-end/agent-skills
beads-guard
Safe Beads workflow helper (warning-only). Use before bd sync/close/create to avoid JSONL conflicts. Ensures you are on a feature branch, up to date with origin/master, and stages Beads files cleanly with Feature-Key commits.
Didn't find tool you were looking for?