fsl-from-code SKILL.md skillA

fsl-from-code 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-from-code@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-from-code/SKILL.md
Versions recorded
6
Latest version
git:20261107.deab533, committed Nov 7, 2026
First version recorded
Jun 25, 2026
Size
8,084 bytes
Repository stars
37
License
Apache-2.0

Reverse-engineer a witnessed FSL design-layer kernel spec from existing code, using the fsl 5 kernel form. Harvest state/actions/guards/effects, confirm cross-action invariants and negative intent with a human, verify and mutation-test, then wire and execute the real-code conformance harness. Use when code is input and a design spec is the deliverable, not requirements/business discovery or design from an upper contract.

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 From Code — implementation → witnessed design model

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

The seam points downward: code → source-witnessed kernel spec → real-code
conformance tests. There is no inferred upper requirements contract. If one is
later agreed, building the upward refinement seam belongs to
[design](../fsl-design/SKILL.md), not automatic reverse-engineering.

Before syntax read [core](../fsl/SKILL.md), its relevant references and
[verify](../fsl-verify/SKILL.md). Produce:

- A kernel `spec` headed `fsl 5`, with `// SRC: file:line` witnesses for
  state/actions/guards/effects and any source-grounded invariants.
- Human-confirmed cross-action safety/history/progress intent, carried in
  `// ASSUME-n:` comments and typed requirement/model/assumption tags.
- A testgen Adapter wired to real code, plus executed random-walk/replay evidence.

Do not invent states/guards/invariants to reach green, create a business or
requirements layer, or claim conformance from model verification alone. A kernel
spec cannot acquire requirements-only scenario/forbidden blocks. Express confirmed
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ymm-oss/fsl/fsl-from-code@sha256:48fa8ce8bd60dec4

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_hv6vt4j737yhcjny.svg)](https://markdownregistry.com/a/art_hv6vt4j737yhcjny)

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

Versions

The registry has recorded 6 versions of this file, between Jun 25, 2026 and Nov 7, 2026, about one every 27 days.

versioncommittedcommitsizeaudit
git:20261107.deab533 latest2026-11-07 deab533 8,084 BA view · diff
git:20261017.bf06ebf2026-10-17 bf06ebf 10,037 BA view · diff
git:20260828.927728f2026-08-28 927728f 9,970 BA view · diff
git:20260706.7fb34172026-07-06 7fb3417 9,951 BA view · diff
git:20260626.58f2f6b2026-06-26 58f2f6b 9,693 BA view · diff
git:20260625.46b80742026-06-25 46b8074 9,492 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 (8084 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_hv6vt4j737yhcjny
GET https://markdownregistry.com/api/v1/resolve?ref=ymm-oss/fsl/fsl-from-code
GET https://markdownregistry.com/api/v1/blob/48fa8ce8bd60dec40745f75ddff36392657a25fba3d38f14052ff311cff7dfcd

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.