design-workflow-graphs SKILL.md skillA

design-workflow-graphs from flc1125/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add flc1125/skills/design-workflow-graphs@git:20260818.a396ecb

Pins git:20260818.a396ecb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
flc1125/skills
Path
skills/design-workflow-graphs/SKILL.md
Versions recorded
1
Latest version
git:20260818.a396ecb, committed Aug 18, 2026
Size
11,123 bytes
Repository stars
39
License
MIT

Design, transform, review, and evolve graph-based workflows with explicit state, nodes, edges, routing, concurrency, joins, loops, approvals, recovery, termination, side effects, and observability. Use when Codex needs to decide whether graph orchestration fits a process; turn requirements, a linear workflow, or an agent loop into a workflow graph; audit an existing DAG or state graph; or produce a framework-neutral graph specification before implementation.

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

# Design Workflow Graphs

Design workflow graphs as explicit engineering contracts rather than decorative diagrams. Make control flow, state mutation, termination, failure behavior, and side effects reviewable before choosing an execution framework.

## Operating Principles

- Start from the objective, state, and termination contract; do not start by inventing agents or nodes.
- Use a graph only when branching, parallelism, bounded iteration, durable recovery, approval gates, or independently observable stages justify it.
- Prefer a linear workflow or one bounded agent loop when it is sufficient.
- Keep deterministic control in edges, guards, budgets, and validation. Use model reasoning inside nodes only where judgment is required.
- Give each state field and side effect an owner.
- Bound every cycle by attempts, elapsed time, cost, or another measurable budget.
- Place irreversible side effects after validation and approval whenever possible.
- Keep the core design framework-neutral. Map it to a runtime only after the graph contract is stable.

## Resource Map

Load only what the request needs:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add flc1125/skills/design-workflow-graphs@sha256:05871c56734ec9ad

The line at the top of this page pins the label git:20260818.a396ecb, 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_mbbktgoc5o3m2qoe.svg)](https://markdownregistry.com/a/art_mbbktgoc5o3m2qoe)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 18, 2026.

versioncommittedcommitsizeaudit
git:20260818.a396ecb latest2026-08-18 a396ecb 11,123 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 (11123 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

flc1125/skills · 39 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mbbktgoc5o3m2qoe
GET https://markdownregistry.com/api/v1/resolve?ref=flc1125/skills/design-workflow-graphs
GET https://markdownregistry.com/api/v1/blob/05871c56734ec9adc9d39b3f5daa74e0e9d84430a1709e08e433496fe30fa0ff

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 flc1125/skills

AGENTS.md AGENTS.md file
flc1125/skills · AGENTS.md
git:20260731.85a4394 · audit A · 39 stars
async SKILL.md skill
flc1125/skills · skills/async/SKILL.md · Launch and coordinate Codex subagents as deferred tasks. Use when the user wants to start bounded subagent work now…
git:20260328.a91fb8e · audit A · 39 stars
code-review SKILL.md skill
flc1125/skills · skills/code-review/SKILL.md · Request or perform a git-backed code review for a defined diff or SHA range using implementation context and…
git:20260328.a91fb8e · audit A · 39 stars
create-plan SKILL.md skill
flc1125/skills · skills/create-plan/SKILL.md · Create and maintain repository-aware technical plans, implementation plans, refactor proposals, design drafts, and…
git:20260714.ca8d851 · audit A · 39 stars
eli5 SKILL.md skill
flc1125/skills · skills/eli5/SKILL.md · Create a simple, picture-first explanation of a topic, defaulting to self-contained HTML. Use when the user says ELI5…
git:20260908.1c9156a · audit A · 39 stars
engineering-backend-architect SKILL.md skill
flc1125/skills · skills/engineering-backend-architect/SKILL.md · Design backend system architecture for new products, large features, platform refactors, API and database design…
git:20260328.a91fb8e · audit A · 39 stars
experts SKILL.md skill
flc1125/skills · skills/experts/SKILL.md · Assemble a panel of experts to assess a problem from multiple professional perspectives, surface agreement and…
git:20260328.a91fb8e · audit A · 39 stars
getnote SKILL.md skill
flc1125/skills · skills/getnote/SKILL.md · Save, search, list, and organize Get 笔记 notes, images, tags, and knowledge resources through the Get 笔记 OpenAPI. Use…
git:20260407.706e71e · audit A · 39 stars
github-create-pr SKILL.md skill
flc1125/skills · skills/github-create-pr/SKILL.md · Create GitHub pull requests from a local branch using a reviewable workflow for branch checks, diff analysis, PR…
git:20260713.53f5fb6 · audit A · 39 stars
github-release-notes-writer SKILL.md skill
flc1125/skills · skills/github-release-notes-writer/SKILL.md · Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and…
git:20260727.1db491f · audit A · 39 stars
github-release-pr-writer SKILL.md skill
flc1125/skills · skills/github-release-pr-writer/SKILL.md · Draft or update GitHub release pull request descriptions from verified tags, commits, merged pull requests, and the…
git:20260727.1db491f · audit A · 39 stars
github-renovate-prs SKILL.md skill
flc1125/skills · skills/github-renovate-prs/SKILL.md · Inspect, triage, approve, and merge GitHub Renovate pull requests with gh. When no repository is provided, use the…
git:20260823.6c50175 · audit A · 39 stars

Every file in flc1125/skills

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