mode-selector SKILL.md skillA

mode-selector from kanevry/session-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kanevry/session-orchestrator/mode-selector@git:20260725.2475346

Pins git:20260725.2475346 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kanevry/session-orchestrator
Path
skills/mode-selector/SKILL.md
Versions recorded
5
Latest version
git:20260725.2475346, committed Jul 25, 2026
First version recorded
May 8, 2026
Size
13,430 bytes
Repository stars
53
License
MIT

Use this skill when performing deterministic mode selection for session-start. Reads Phase A STATE.md recommendations + (future) learnings, sessions, backlog, bootstrap signals and returns {mode, rationale, confidence, alternatives}. Pure-function contract — no side effects, no STATE.md writes. Phase B scaffold (issue #276); full heuristic is follow-up sub-issues.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Mode-Selector Skill

## Status

Heuristic v1 active (issue #291, shipped 2026-04-25). Wired into session-start Phase 7.5
(issue #292, shipped 2026-04-25). Backlog signal source live (issue #293, shipped 2026-04-25):
`signals.backlog` is populated by `scripts/lib/backlog-scan.mjs::scanBacklog`. Accuracy feedback
loop live (issue #294, shipped 2026-04-25): `scripts/lib/mode-selector-accuracy.mjs::recordAccuracy`
writes a `mode-selector-accuracy` learning after the user confirms/overrides the Phase 7.5 banner.
Phase B contract is **closed**. Phase C (#277) `/autopilot` Loop Command is the next epic and
owns its own PRD.

## Purpose

Mode-Selector centralizes the session-mode decision across all consumers: session-start Phase 1.5
banner, `/autopilot` (Phase C), and any future caller that needs a structured recommendation rather
than ad-hoc heuristics inline at the call site. Before this skill existed, mode-picking logic was
either implicit (user-typed free text) or embedded directly in session-start with no reuse path.

Phase A (`state-md.mjs::parseRecommendations`, issue #272) established the `recommended-mode`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanevry/session-orchestrator/mode-selector@sha256:e96ba9bc668117d9

The line at the top of this page pins the label git:20260725.2475346, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3vjl7tag7b24ia4u.svg)](https://markdownregistry.com/a/art_3vjl7tag7b24ia4u)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 8, 2026 and Jul 25, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260725.2475346 latest2026-07-25 2475346 13,430 BA view · diff
git:20260708.8f98a542026-07-08 8f98a54 13,429 BA view · diff
git:20260518.a68e94f2026-05-18 a68e94f 13,389 BA view · diff
git:20260517.a84eba82026-05-17 a84eba8 13,431 BA view · diff
git:20260508.7158b822026-05-08 7158b82 13,387 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13430 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kanevry/session-orchestrator · 53 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3vjl7tag7b24ia4u
GET https://markdownregistry.com/api/v1/resolve?ref=kanevry/session-orchestrator/mode-selector
GET https://markdownregistry.com/api/v1/blob/e96ba9bc668117d9acd216e353abf24f7c8b1dcb2173398fb8838074735e4d3f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kanevry/session-orchestrator

architecture SKILL.md skill
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
git:20261003.c34ec50 · audit A · 53 stars
autopilot SKILL.md skill
kanevry/session-orchestrator · .agents/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
git:20260919.176b605 · audit A · 53 stars
bootstrap SKILL.md skill
kanevry/session-orchestrator · .agents/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked…
git:20260919.176b605 · audit A · 53 stars
brainstorm SKILL.md skill
kanevry/session-orchestrator · .agents/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
git:20260919.176b605 · audit A · 53 stars
claude-md-drift-check SKILL.md skill
kanevry/session-orchestrator · .agents/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
git:20261003.c34ec50 · audit A · 53 stars
close SKILL.md skill
kanevry/session-orchestrator · .agents/skills/close/SKILL.md · End session with verification, commits, and documentation
git:20260919.176b605 · audit A · 53 stars
convergence-monitoring SKILL.md skill
kanevry/session-orchestrator · .agents/skills/convergence-monitoring/SKILL.md · Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity —…
git:20260919.176b605 · audit A · 53 stars
debug SKILL.md skill
kanevry/session-orchestrator · .agents/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
git:20260919.176b605 · audit A · 53 stars
deepen SKILL.md skill
kanevry/session-orchestrator · .agents/skills/deepen/SKILL.md · Make a task deeper, not bigger. Use when the user asks for a deeper or more ambitious version of a task (tiefer, geh…
git:20261027.7eb9aed · audit A · 53 stars
discovery SKILL.md skill
kanevry/session-orchestrator · .agents/skills/discovery/SKILL.md · Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the…
git:20260919.176b605 · audit A · 53 stars
dispatcher SKILL.md skill
kanevry/session-orchestrator · .agents/skills/dispatcher/SKILL.md · Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates…
git:20260919.176b605 · audit A · 53 stars
docs-orchestrator SKILL.md skill
kanevry/session-orchestrator · .agents/skills/docs-orchestrator/SKILL.md · Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to…
git:20260919.176b605 · audit A · 53 stars

Every file in kanevry/session-orchestrator

Other files named mode-selector

mode-selector SKILL.md skill
kanevry/session-orchestrator · .cursor/skills/mode-selector/SKILL.md · Use this skill when performing deterministic mode selection for session-start. Reads Phase A STATE.md recommendations +…
git:20260825.0626387 · audit A · 53 stars
mode-selector SKILL.md skill
kanevry/session-orchestrator · .codex-plugin/skills/mode-selector/SKILL.md · Use this skill when performing deterministic mode selection for session-start. Reads Phase A STATE.md recommendations +…
git:20260907.cf0876c · audit A · 53 stars
mode-selector SKILL.md skill
kanevry/session-orchestrator · .agents/skills/mode-selector/SKILL.md · Use this skill when performing deterministic mode selection for session-start. Reads Phase A STATE.md recommendations +…
git:20260919.176b605 · audit A · 53 stars

Browse by kind, by grade A, or by owner.