Home / richfrem / agent-plugins-skills · plugins/agent-agentic-os/skills/transition-simulator/SKILL.md · GitHub

transition-simulator skillA

transition-simulator is agent-read markdown (skill) from richfrem/agent-plugins-skills: Simulates and validates SQLite control-plane state transitions. Supports both fast deterministic simulation (PipelineSimulator) and behavioral cheap-model dry-runs. Verifies what the agent knows to do itself, what questions to ask the human, what commands the human runs vs what the agent runs (enforcing the AGENT-RUNNABLE / SOFT / HARD 3-class taxonomy), valid/invalid transitions, and minimization of friction. Trigger with "simulate transition", "test this transition", "verify transition guidanc.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Transition Simulator

## Purpose

The **Transition Simulator** provides comprehensive verification of the control-plane pipeline lifecycle. It proves transitions across three critical dimensions:
1. **Structural & Deterministic Simulation** (`PipelineSimulator`): Proves the state machine accepts and rejects transitions given programmatic conditions, enforces receipt provenance, validates SQLite triggers, and enforces the 3-class edge taxonomy without running LLM calls.
2. **Behavioral Simulation** (`run_transition_simulation.py`): Proves the printed YAML guidance, question prompts, and human interactions are followable by an agent reading them cold, with no prior context across supported CLI backends (`agy`, `claude`).
3. **Post-DONE Convergence Verification** (`PipelineSimulator.get_post_done_convergence_protocol`, `grade_post_done_convergence_plan`): Verifies the 4-step git convergence sequence (`PUSH_AND_PR` -> `WAIT_FOR_MERGE` -> `SYNC_LOCAL_MAIN` -> `PRUNE_WORKTREE`) codified in the `DONE` stage closeout contract.

All modes verify that the agent knows:
- What it must do itself (read-first rules, deterministic pre-checks, artifact generation).
…

Read the whole file at its exact version.

How to install

Latest version
mdr add richfrem/agent-plugins-skills/transition-simulator@git:20260920.f29a152
Exact content
mdr add richfrem/agent-plugins-skills/transition-simulator@sha256:846cda454d696139

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.f29a152 latest2026-09-20 f29a152 7,079 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (7079 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

richfrem/agent-plugins-skills · 6 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_p5x5qxzlnr6uzd5c
GET https://markdownregistry.com/api/v1/resolve?ref=richfrem/agent-plugins-skills/transition-simulator
GET https://markdownregistry.com/api/v1/blob/846cda454d6961390b7b206aab4b673eb96b67fac8e551df611cc79576cb8c90

Your agent 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.

More from richfrem/agent-plugins-skills

AGENTS.md agents
richfrem/agent-plugins-skills · AGENTS.md
git:20260920.f29a152 · audit A · 6 stars
CLAUDE.md claude
richfrem/agent-plugins-skills · CLAUDE.md
git:20260922.9ef340f · audit A · 6 stars
critical-auditor skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/critical-auditor/SKILL.md · Conducts a full-system adversarial audit of agent plugins, skills, specifications, and orchestration against enforced…
git:20260905.1c3b5a5 · audit A · 6 stars
evo-smoketest skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/evo-smoketest/SKILL.md · Converts temperatures between Celsius and Fahrenheit for the evolution end-to-end smoke test harness.
v0.1.0 · audit A · 6 stars
issue-resolution-reviewer skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/issue-resolution-reviewer/SKILL.md · Audits closed GitHub issues to verify whether root causes were genuinely resolved, if follow-on execution friction…
git:20260905.0cab9b3 · audit A · 6 stars
optimize-agent-instructions skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/optimize-agent-instructions/SKILL.md · Audits and rewrites the canonical AGENTS.md instruction file in any repo. Strips stale or foreign content and applies…
git:20260916.9da4b53 · audit A · 6 stars
os-architect skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-architect/SKILL.md · SME-facing front-door skill for Agentic OS ecosystem evolution. Invokes the os-architect interview flow: classifies…
git:20260827.e760414 · audit A · 6 stars
os-clean-locks skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-clean-locks/SKILL.md · Safely removes all agent lock files from the context/.locks/ directory to resolve deadlocks caused by crashed agents…
git:20260427.a7c1e49 · audit A · 6 stars
os-environment-probe skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-environment-probe/SKILL.md · Discovers and persists the user's available AI environments (Claude, Copilot CLI, Agy CLI, Cursor, etc.) to…
git:20260907.4f6c1a5 · audit A · 6 stars
os-eval-backport skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-eval-backport/SKILL.md · Reviews a completed os-eval-runner lab run and backports approved changes to master plugin sources. Trigger with…
git:20260907.4f6c1a5 · audit A · 6 stars
os-eval-lab-setup skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-eval-lab-setup/SKILL.md · Bootstraps a skill evaluation lab repo for an autoresearch improvement run. Trigger with "set up an eval lab"…
git:20260907.4f6c1a5 · audit A · 6 stars
os-eval-runner skill
richfrem/agent-plugins-skills · plugins/agent-agentic-os/skills/os-eval-runner/SKILL.md · Stateless evaluation engine that scores and gates skill improvement iterations using headless Python evaluation…
git:20260628.325c1b7 · audit A · 6 stars

Every file in richfrem/agent-plugins-skills

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