setup-freeflow SKILL.md skillA

setup-freeflow from hassan-mohiddin/freeflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hassan-mohiddin/freeflow/setup-freeflow@git:20260925.4e1eba8

Pins git:20260925.4e1eba8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hassan-mohiddin/freeflow
Path
skills/setup-freeflow/SKILL.md
Versions recorded
5
Latest version
git:20260925.4e1eba8, committed Sep 25, 2026
First version recorded
Aug 21, 2026
Size
6,325 bytes
Repository stars
4
License
MIT

Use when activating Freeflow in a repository, repairing its repository or personal configuration, or checking whether the current host is delivering Freeflow context.

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

# Setup Freeflow

Create or repair the smallest valid layered setup. Keep repository activation, personal overrides, and host runtime delivery as separate facts.

- `.freeflow/config.json` is the required shared repository activation config.
- `.freeflow/local.json` is an optional per-checkout personal override. It cannot activate Freeflow by itself.
- Runtime delivery depends on the current host's installed and trusted adapter.

Answer setup questions and delivery checks read-only. An explicit action request authorizes the smallest selected setup change under the state rules below. When repository config is missing, first activation authorizes minimal shared config; it does not authorize personal overrides, optional capabilities, replacement of invalid config, or edits to repo-owned host instructions.

Read [the activation contract](references/activation-contract.md) before changing setup state. Read [host setup](references/host-setup.md) when runtime delivery, lifecycle, or host trust matters.

## Establish Mutation Authority

Classify the current state before editing:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hassan-mohiddin/freeflow/setup-freeflow@sha256:fa15c2b46f5b32e3

The line at the top of this page pins the label git:20260925.4e1eba8, 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_zwaksee3tp2tnhto.svg)](https://markdownregistry.com/a/art_zwaksee3tp2tnhto)

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

Versions

The registry has recorded 5 versions of this file, between Aug 21, 2026 and Sep 25, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20260925.4e1eba8 latest2026-09-25 4e1eba8 6,325 BA view · diff
git:20260826.f0227432026-08-26 f022743 6,098 BA view · diff
git:20260824.ac6e5d82026-08-24 ac6e5d8 6,168 BA view · diff
git:20260821.a8a32642026-08-21 a8a3264 6,186 BA view · diff
git:20260821.506bc982026-08-21 506bc98 5,873 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 (6325 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

hassan-mohiddin/freeflow · 4 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zwaksee3tp2tnhto
GET https://markdownregistry.com/api/v1/resolve?ref=hassan-mohiddin/freeflow/setup-freeflow
GET https://markdownregistry.com/api/v1/blob/fa15c2b46f5b32e36dacee9aa1cc744c8482e371b2e5a915c6fe07fe2044270e

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 hassan-mohiddin/freeflow

delegation-harness SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/delegation-harness/evals/subjects/neutral/SKILL.md · Use when coordinating Freeflow Pi/cmux pane delegation, orchestrator/planning-parent/execution-parent workflows, task…
git:20260821.506bc98 · audit A · 4 stars
delegation-harness SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/delegation-harness/skills/delegation-harness/SKILL.md · Use when coordinating Freeflow Pi/cmux pane delegation, orchestrator/planning-parent/execution-parent workflows, task…
git:20260821.506bc98 · audit A · 4 stars
context-virtualization SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/legacy-context/capabilities/context-virtualization/SKILL.md · Use after broad or noisy tool evidence has been safely narrowed or exhausted, or when an activity boundary leaves raw…
git:20260925.4e1eba8 · audit A · 4 stars
conversation-history SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/legacy-context/capabilities/conversation-history/SKILL.md · Use when the next decision requires exact prior conversation wording, rationale, chronology, or provenance that is…
git:20260925.4e1eba8 · audit A · 4 stars
mode-contract SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/modes/qualification/subjects/neutral/mode-contract/SKILL.md · Use when a user asks to set, change, infer, or discuss conversation/workflow/strict-workflow mode, or when task risk…
git:20260826.f022743 · audit A · 4 stars
mode-contract SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/modes/skills/mode-contract/SKILL.md · Use when choosing, changing, or explaining how Freeflow mode applies to current work.
git:20260826.f022743 · audit A · 4 stars
output-router SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/output-router/capabilities/output-router/SKILL.md
git:20260822.9c5afa5 · audit C · 4 stars
output-router SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/output-router/skill-eval/qualification/subjects/neutral/output-router/SKILL.md · Use after the Workflow, Decision Gate, or Discuss route is clear when choosing between native tools and Freeflow routed…
git:20260822.9c5afa5 · audit A · 4 stars
review-pr SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/skill-evals-v1/fixtures/tiny-eval-method-app/skills/review-pr/SKILL.md · Use when reviewing a pull request or local diff before merge.
git:20260821.506bc98 · audit B · 4 stars
triage-question SKILL.md skill
hassan-mohiddin/freeflow · .deprecated/skill-evals-v1/fixtures/tiny-eval-method-app/skills/triage-question/SKILL.md · Use when the user asks whether an issue, task, or product decision already exists.
git:20260821.506bc98 · audit A · 4 stars
AGENTS.md@.deprecated/skill-evals-v1/fixtures/tiny-post-setup-invalid-config-app AGENTS.md file
hassan-mohiddin/freeflow · .deprecated/skill-evals-v1/fixtures/tiny-post-setup-invalid-config-app/AGENTS.md
git:20260821.506bc98 · audit B · 4 stars
AGENTS.md@.deprecated/skill-evals-v1/fixtures/tiny-post-setup-missing-config-app AGENTS.md file
hassan-mohiddin/freeflow · .deprecated/skill-evals-v1/fixtures/tiny-post-setup-missing-config-app/AGENTS.md
git:20260821.506bc98 · audit B · 4 stars

Every file in hassan-mohiddin/freeflow

Other files named setup-freeflow

setup-freeflow SKILL.md skill
hassan-mohiddin/freeflow · .skill-eval/review-suite/fixtures/rs-0b8e9c15/clean/workspace/files/skills/setup-freeflow/SKILL.md · Use when activating Freeflow in a repository, repairing its repository or personal configuration, or checking whether…
git:20261012.5a973db · audit A · 4 stars
setup-freeflow SKILL.md skill
hassan-mohiddin/freeflow · .skill-eval/qualification/subjects/neutral/setup-freeflow/SKILL.md · Use when activating Freeflow in a repository, repairing its repository or personal configuration, or checking whether…
git:20260718.e3de18c · audit A · 4 stars
setup-freeflow SKILL.md skill
hassan-mohiddin/freeflow · .skill-eval/review-suite/fixtures/rs-0b8e9c15/seeded/workspace/files/skills/setup-freeflow/SKILL.md · Use when activating Freeflow in a repository, repairing its repository or personal configuration, or checking whether…
git:20261012.5a973db · audit A · 4 stars

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