Agent-Skills.md

Agent Skills: Session Documenter Skill

Document session work with explicit commands. Use /start to begin tracking, /end to finalize session, /clear to reset. Tracks decisions, file changes, and context for continuity.

UncategorizedID: shipshitdev/library/session-documenter

Repository

shipshitdev/library
shipshitdev
151

Install this agent skill to your local

pnpm dlx add-skill https://github.com/shipshitdev/library/tree/HEAD/bundles/session/skills/session-documenter

Skill Files

Browse the full folder contents for session-documenter.

Download Skill

Loading file tree…

bundles/session/skills/session-documenter/SKILL.md

Skill Metadata

Name
session-documenter
Description
Document session work with explicit commands. Use /start to begin tracking, /end to finalize session, /clear to reset. Tracks decisions, file changes, and context for continuity.

Session Documenter Skill

Document work, decisions, and context with explicit commands.

Commands

| Command | Action | |---------|--------| | /start | Begin new session - creates/appends to today's file, loads context | | /end | Finalize session - writes entry with all tracked work, updates related files |

How It Works

  1. /start - Creates .agents/SESSIONS/YYYY-MM-DD.md if missing, or loads existing context
  2. During session - You tell me what to track: decisions, files changed, mistakes
  3. /end - I write the full session entry with flowcharts, decisions, next steps

Critical Rules

Session File Naming (ONE FILE PER DAY)

✅ CORRECT: .agents/SESSIONS/2025-11-15.md
❌ WRONG:   .agents/SESSIONS/2025-11-15-feature-name.md

Multiple sessions same day → Same file, Session 1, Session 2, etc.

Flowcharts (MANDATORY for features)

Include flowchart for:

  • New features
  • Feature modifications
  • Multi-component bug fixes

Session Entry Structure

  1. Session number and title
  2. System flow diagram (mermaid or text)
  3. Affected components (frontend, backend, data, external)
  4. What was done (task checklist)
  5. Key decisions (with rationale)
  6. Files changed
  7. Mistakes and fixes
  8. Next steps

Related Files to Update

  • .agents/SESSIONS/README.md
  • .agents/SYSTEM/SUMMARY.md
  • .agents/TASKS/*/TODO.md
  • .agents/SYSTEM/ARCHITECTURE.md (if architectural decisions)

References

Session Documenter Skill Skill | Agent Skills