session-workflow

Enforce startup and shutdown checks for AI-assisted development sessions.

7|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/rloisell/rl-agents-n-skills --skill session-workflow-rloisell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-workflow
Source: https://github.com/rloisell/rl-agents-n-skills/tree/main/session-workflow
Command: npx skills add https://github.com/rloisell/rl-agents-n-skills --skill session-workflow-rloisell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a consistent startup and shutdown discipline for AI-assisted development sessions to prevent lost work, undocumented changes, and inconsistent session state across collaborators and tools.

Core Features & Use Cases

  • Orientation Summary: Reads AI/nextSteps.md and related orientation files and produces a one-sentence session summary to establish context.
  • Git and PR Hygiene: Checks git status and recent commits, enforces branching before edits, and identifies Dependabot PRs for inclusion in the session plan.
  • AI Session File Maintenance: Updates WORKLOG, CHANGES, COMMANDS, and COMMIT_INFO at session end and guides commits and PR creation without pushing directly to main.
  • Use Case: At the start of a paired development session, run the Skill to summarise outstanding work, confirm branch state, and ensure Dependabot updates are captured in nextSteps before coding begins.

Quick Start

Ask the session-workflow agent to run startup checks, summarise AI/nextSteps.md in one sentence, report uncommitted changes, and advise the branch to use.

Frequently Asked Questions about session-workflow

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

FAQPage Schema
How do I maintain consistent git state and AI session files across development sessions?

Maintain consistent git state by running session startup and shutdown checks that read orientation files, verify git status, list Dependabot PRs, and update AI session files before pushing commits to a non-main branch.

What's the best way to review Dependabot PRs before starting a new coding session?

Review Dependabot PRs before coding by executing a session startup check that identifies open PRs and incorporates them into your nextSteps.md orientation file, ensuring updates are captured in the session plan.

How do I prevent accidental direct commits to the main branch during an AI-assisted workflow?

Prevent direct commits to main by enforcing a branching protocol that checks git status, advises the correct working branch, and guides commit and PR creation while blocking any direct pushes to the main branch.

How does AI session file maintenance work at the end of a development session?

AI session file maintenance updates WORKLOG, CHANGES, COMMANDS, and COMMIT_INFO files at session end, documenting all modifications and guiding commits to a feature branch rather than main.

Do I need existing orientation files like nextSteps.md to run session startup checks?

You need existing orientation files like AI/nextSteps.md for the Skill to read and produce a one-sentence session summary, establishing context before it checks git status and recent commits.

Why should I use a structured session workflow for AI-assisted development?

Use a structured session workflow for AI-assisted development to prevent lost work, undocumented changes, and inconsistent session state across collaborators by enforcing strict startup and shutdown discipline.