skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
shipshitdev/skills67 installs

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-start
view source ↗

Is 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-documenter to track the active session
  • rules-capture if 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_verified or status: temporary files)
  • 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

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>