session-start
Loads critical project context and recent session history at the start of each session or after `/clear` — reads `.agents/memory/` source-of-truth files, surfaces open next steps from the latest session log, and activates the session-documenter. Triggers on: session start, `/clear`, "load context", "start session", or first message in a new agent session.
How do I install this agent skill?
npx skills add https://github.com/shipshitdev/skills --skill session-startIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill initializes the agent's workspace by loading session history, user preferences, and task lists from the local filesystem. It operates entirely on local files within the project and does not perform network requests or execute suspicious commands.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Session Start
Load critical context and recent history at the start of each session or after /clear.
Contract
Inputs:
- Project root
- Current date
- Existing
.agents/memory/and.agents/sessions/files
Outputs:
- Loaded repo memory summary
- Today's session context (if any)
- Open next-steps surfaced from the latest session log
Creates/Modifies:
- No required writes
- May create today's session file only through
session-documenter
External Side Effects:
- None
Confirmation Required:
- Before creating or rewriting session files when paths are ambiguous
Delegates To:
session-documenterto track the active sessionrules-captureif startup reveals uncaptured preferences
Workflow
1. Read Repo Memory (CRITICAL — source of truth)
Read the repo's memory files at .agents/memory/. These are the source of truth
for current project context: architecture, deployment state, migrations, known
gotchas, and operating decisions. Apply the staleness and temporary-file checks
defined in the global CLAUDE.md / MEMORY.md before citing any entry.
2. Read Today's Session File
Read today's session to understand what was already done before /clear:
Read today's session file at .agents/sessions/YYYY-MM-DD.md (where YYYY-MM-DD
is today's date).
If the file exists, it shows tasks completed, decisions made, files changed, mistakes, and next steps. If it doesn't exist yet, this is a fresh session day.
3. Activate Session Documenter
Run the session-documenter skill to track work throughout the session.
4. Confirmation
After reading memory and the session file, provide a brief confirmation (5-7 bullet points max):
- Critical rules understood
- Repo memory loaded (flag any stale
last_verifiedorstatus: temporaryfiles) - Today's session context loaded (if it exists)
- Session documenter active
- Open next-steps surfaced from the latest session log (if any)
Related Skills
- session-end — Document session before clearing context
- session-documenter — Tracks work throughout the session
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/shipshitdev/skills/session-start">View session-start on skillZs</a>