fsl-design-review SKILL.md skillA

fsl-design-review from ymm-oss/fsl is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ymm-oss/fsl/fsl-design-review@git:20261107.deab533

Pins git:20261107.deab533 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ymm-oss/fsl
Path
skills/fsl-design-review/SKILL.md
Versions recorded
10
Latest version
git:20261107.deab533, committed Nov 7, 2026
First version recorded
Jul 6, 2026
Size
9,314 bytes
Repository stars
37
License
Apache-2.0

Review FSL design proposals, variants, extensions, changes, and substitutability against a frozen abstract contract. Use fslc refine plus independent model verification, enabledness review and implementation anchoring where required, reporting scoped evidence in SOLID/LSP/OCP/DbC vocabulary. Use fsl-design for authoring a design from requirements; this skill owns the review procedure, not language syntax.

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

# FSL Design Exploration — contract-conformance review

A headerless document is FSL 4; to migrate it, see the migration guide in `docs/manual/LANGUAGE.md` ("FSL 4 to FSL 5 migration").

Translate “is this design good?” into explicit contract questions. Design principles
are judgment lenses, not properties that the verifier magically proves. Read
[core](../fsl/SKILL.md) and its needed references for syntax/repair, and
[verify](../fsl-verify/SKILL.md) for runs/claims. For a new design-layer file use
[design](../fsl-design/SKILL.md), then return here. Kernel proposals are headed
`fsl 5`; requirements surface grammar remains owned by its layer skill and maps
through canonical lowered names.

## Step 1 — identify the open and closed parts

Whether comparing proposals, adding a variant, reviewing a change or judging
substitutability, agree in chat on:

- **Open:** what may change, variants, extension points and changed sites.
- **Closed:** observable state, guards, invariants and responses that must hold.
- Action/state correspondence, intended stutters, and human-owned judgments.

OCP lens: choose the stable boundary. DIP lens: identify the shared abstraction.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ymm-oss/fsl/fsl-design-review@sha256:e3b6e46920b7990d

The line at the top of this page pins the label git:20261107.deab533, 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_i3esbwom2cehjs6u.svg)](https://markdownregistry.com/a/art_i3esbwom2cehjs6u)

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

Versions

The registry has recorded 10 versions of this file, between Jul 6, 2026 and Nov 7, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261107.deab533 latest2026-11-07 deab533 9,314 BA view · diff
git:20261017.bf06ebf2026-10-17 bf06ebf 15,564 BA view · diff
git:20261011.e8e589e2026-10-11 e8e589e 15,728 BA view · diff
git:20261011.96ca2d52026-10-11 96ca2d5 15,210 BA view · diff
git:20261002.458040f2026-10-02 458040f 14,871 BA view · diff
git:20260828.927728f2026-08-28 927728f 11,716 BA view · diff
git:20260725.1fa07e62026-07-25 1fa07e6 11,716 BA view · diff
git:20260708.bb85ca22026-07-08 bb85ca2 11,422 BA view · diff
git:20260706.5f1ad182026-07-06 5f1ad18 11,319 BA view · diff
git:20260706.7fb34172026-07-06 7fb3417 10,770 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 (9314 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

ymm-oss/fsl · 37 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i3esbwom2cehjs6u
GET https://markdownregistry.com/api/v1/resolve?ref=ymm-oss/fsl/fsl-design-review
GET https://markdownregistry.com/api/v1/blob/e3b6e46920b7990dbf261a9bc86c176fea1ea8852c92fc2294f74201013a5a32

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 ymm-oss/fsl

checkpoint SKILL.md skill
ymm-oss/fsl · .agents/skills/checkpoint/SKILL.md · Reconcile tasks/active.md with Git, changed files, and observed verification before compaction, clearing, or handoff.
git:20260802.de79983 · audit A · 37 stars
focused-change SKILL.md skill
ymm-oss/fsl · .agents/skills/focused-change/SKILL.md · Make a bounded repository change with narrow discovery, minimal diffs, staged validation, concise evidence, and…
git:20260917.509bb63 · audit A · 37 stars
task-start SKILL.md skill
ymm-oss/fsl · .agents/skills/task-start/SKILL.md · Create or refresh the verified, resumable task packet in tasks/active.md before substantial FSL repository work.
git:20260802.de79983 · audit A · 37 stars
add-language-feature SKILL.md skill
ymm-oss/fsl · .claude/skills/add-language-feature/SKILL.md · Scaffold and verify a new native Rust FSL language feature while keeping syntax, lowering, symbolic/concrete semantics…
git:20260929.d8a8acc · audit A · 37 stars
checkpoint SKILL.md skill
ymm-oss/fsl · .claude/skills/checkpoint/SKILL.md · Reconcile and save the current FSL task state before compaction, clearing, handoff, or ending substantial work.
git:20260802.de79983 · audit A · 37 stars
new-spec SKILL.md skill
ymm-oss/fsl · .claude/skills/new-spec/SKILL.md · Author a new or substantially changed .fsl spec and take it through native check, bounded verification, induction where…
git:20260828.927728f · audit A · 37 stars
pr-review SKILL.md skill
ymm-oss/fsl · .claude/skills/pr-review/SKILL.md · Independently review a pull request that resolves an issue. Reconstructs the issue contract from repository evidence…
git:20260929.d8a8acc · audit A · 37 stars
release SKILL.md skill
ymm-oss/fsl · .claude/skills/release/SKILL.md · Operate FSL's GitLab Flow-inspired lifecycle from short-lived branches through main and production to an exact vX.Y.Z…
git:20261107.8d448ce · audit A · 37 stars
task-start SKILL.md skill
ymm-oss/fsl · .claude/skills/task-start/SKILL.md · Create or refresh the worktree-local active task packet before substantial FSL repository work. Reconciles the…
git:20260802.de79983 · audit A · 37 stars
AGENTS.md AGENTS.md file
ymm-oss/fsl · AGENTS.md
git:20260929.d8a8acc · audit A · 37 stars
CLAUDE.md CLAUDE.md file
ymm-oss/fsl · CLAUDE.md
git:20260929.d8a8acc · audit A · 37 stars
fsl-business SKILL.md skill
ymm-oss/fsl · skills/fsl-business/SKILL.md · Write and verify FSL business-layer specs and governance catalogs for consultants, business owners, and PMs explicitly…
git:20261107.deab533 · audit A · 37 stars

Every file in ymm-oss/fsl

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