system-flow-mapper SKILL.md skillB

system-flow-mapper from omarsaleh506/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add omarsaleh506/skills/system-flow-mapper@git:20261006.1f9c93b

Pins git:20261006.1f9c93b in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
omarsaleh506/skills
Path
skills/system-flow-mapper/SKILL.md
Versions recorded
3
Latest version
git:20261006.1f9c93b, committed Oct 6, 2026
First version recorded
Jun 28, 2026
Size
22,608 bytes
Repository stars
3
License
MIT

Produces three grounded deliverables for ANY codebase by reading it (source unchanged), written into the project under docs/system-flow/: SYSTEM_FLOW.md (deep technical reference), system-flow.html (jargon-free offline companion for non-technical readers), and system-flow-technical.html (interactive offline reference for engineers: searchable endpoint cards, actor sidebar, sequence diagrams, light/dark toggle). Detects project type first and routes to the right playbook…

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

# System Flow Mapper

Reproduce, on any project, a three-part deliverable:

1. **`$DOCS_DIR/SYSTEM_FLOW.md`** — the source-of-truth
   technical map (how data moves, what each actor can do, the data model, async paths,
   and a tech-debt list).
2. **`$DOCS_DIR/system-flow.html`** — a self-contained,
   fully-offline, jargon-free visual companion for non-technical readers.
3. **`$DOCS_DIR/system-flow-technical.html`** — a
   self-contained, fully-offline, interactive technical reference: searchable endpoint
   cards with method badges and role chips, actor-scoped sidebar navigation, sequence
   diagrams, and a light/dark toggle. For engineers and reviewers.

`$DOCS_DIR` is `docs/system-flow/` inside the analyzed project (computed in Step 0c).

This is a **read-only analysis of the project's source** — never change
application, config, or source files. The only files you create are this skill's
own deliverables under `$DOCS_DIR/` (the three docs, per-section fragments, and
`state.json`). The one project file you may touch is `.gitignore`, and only with
the user's say-so (see Step 0c).

The bar: deep, **grounded** (every claim cites a real `path:line`), and honest
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add omarsaleh506/skills/system-flow-mapper@sha256:2231114c2c9c0eee

The line at the top of this page pins the label git:20261006.1f9c93b, 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_dnyxi2uw3t53xljj.svg)](https://markdownregistry.com/a/art_dnyxi2uw3t53xljj)

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

Versions

The registry has recorded 3 versions of this file, between Jun 28, 2026 and Oct 6, 2026, about one every 50 days.

versioncommittedcommitsizeaudit
git:20261006.1f9c93b latest2026-10-06 1f9c93b 22,608 BB view · diff
git:20260629.84d7f0a2026-06-29 84d7f0a 22,033 BB view · diff
git:20260628.18032ca2026-06-28 18032ca 21,878 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (22608 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 script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

omarsaleh506/skills · 3 stars · license MIT · pushed 2026-10-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dnyxi2uw3t53xljj
GET https://markdownregistry.com/api/v1/resolve?ref=omarsaleh506/skills/system-flow-mapper
GET https://markdownregistry.com/api/v1/blob/2231114c2c9c0eeed67ab6df60b73c6b7a15b6ef27809c1c385d0a36fbde2343

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

CLAUDE.md CLAUDE.md file
omarsaleh506/skills · CLAUDE.md
git:20260629.2d500d5 · audit A · 3 stars
ai-os-init SKILL.md skill
omarsaleh506/skills · skills/ai-os-init/SKILL.md · Scaffolds an "AI Operating System" project structure into any project, non-destructively — adds only missing pieces…
git:20261006.008e80e · audit A · 3 stars
clean-tests SKILL.md skill
omarsaleh506/skills · skills/ai-os-init/templates/.claude/skills/clean-tests/SKILL.md · Audits and refactors existing test files for quality — removes brittle assertions, fixes implementation coupling…
git:20261006.008e80e · audit A · 3 stars
new-adr SKILL.md skill
omarsaleh506/skills · skills/ai-os-init/templates/.claude/skills/new-adr/SKILL.md · Creates a new Architecture Decision Record (ADR) in docs/decisions/. Auto-numbers the file based on the highest…
git:20260628.cd7722f · audit A · 3 stars
CLAUDE.md@skills/ai-os-init/templates CLAUDE.md file
omarsaleh506/skills · skills/ai-os-init/templates/CLAUDE.md
git:20260628.cd7722f · audit A · 3 stars
shop-scout SKILL.md skill
omarsaleh506/skills · skills/shop-scout/SKILL.md · Comparison-shops any product across many online stores, finds the genuinely cheapest option after discounts, surfaces…
git:20261007.0c6d22c · audit A · 3 stars
sqlalchemy-patterns SKILL.md skill
omarsaleh506/skills · skills/sqlalchemy-patterns/SKILL.md · Comprehensive SQLAlchemy 2.0+ async + PostgreSQL patterns — declarative models, relationships, type-safe Mapped[…
git:20261006.98751eb · audit A · 3 stars

Every file in omarsaleh506/skills

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