stark-session

Manages development session start briefings and end-of-session test, merge, commit, and push workflows.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/21StarkCom/stark-skills --skill stark-session-21starkcom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stark-session
Source: https://github.com/21StarkCom/stark-skills/tree/main/runtime-overrides/codex/skill/stark-session
Command: npx skills add https://github.com/21StarkCom/stark-skills --skill stark-session-21starkcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a work session means manually checking git state, open PRs, health checks, and project boards, while ending one means remembering to run tests, merge PRs, commit docs, and push — this Skill automates both bookends of a development session. ## Core Features & Use Cases - Session Start Briefing: Collects git state, open PRs, board items, alerts, health checks, and queue status into one JSON blob via a TypeScript CLI, then renders a concise prioritized briefing and task list. - Session End Workflow: Runs configured test/build commands, offers to merge open PRs via gh, commits doc updates, checkpoints session state, pushes the branch, and renders a summary with diff statistics. - Use Case: A developer returning to a repo runs session start to get a catch-up briefing with a prioritized task list, works through it, then runs session end to test, merge their PR, commit docs, and push in one guided flow. ## Quick Start Ask the AI to start my session and give me a briefing of the repo state, open PRs, and what to work on first.

Frequently Asked Questions about stark-session

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

FAQPage Schema
How do I get a summary of repo state and open PRs at session start?▼

Invoke the session start mode, which runs a TypeScript collector that gathers git status, open PRs, board items, alerts, and health checks into one JSON blob. The AI renders this as a concise briefing with a prioritized task list.

How do I automate tests, PR merges, and push at the end of a coding session?▼

Session end mode runs your configured test and build commands, offers to merge open PRs with gh using your configured merge strategy, commits doc updates, checkpoints state, and pushes the branch. It finishes with a summary including diff statistics.

Does this work with both Claude Code and Codex?▼

Yes, session identity resolves from STARK_SESSION_ID, CODEX_THREAD_ID, or CLAUDE_SESSION_ID depending on the host. It reads AGENTS.md for Codex-compatible hosts and CLAUDE.md for Claude Code during context loading.

What happens if the session state collection fails?▼

The TypeScript CLI is failure-safe: failed collectors produce null slots and log entries in an errors array rather than crashing. If the entire JSON output is empty, the skill falls back to plain git status and gh pr list.

How are test and build commands configured for session end?▼

Commands come from .code-review/config.json, resolved hierarchically from global to org to repo level. The session.test_command and session.build_command keys take precedence, falling back to top-level keys, with null defaults if unset.