guidance SKILL.md skillA

guidance from eric-cielo/moflo is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add eric-cielo/moflo/guidance@git:20260807.4aab77c

Pins git:20260807.4aab77c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
eric-cielo/moflo
Path
.claude/skills/guidance/SKILL.md
Versions recorded
5
Latest version
git:20260807.4aab77c, committed Aug 7, 2026
First version recorded
May 6, 2026
Size
19,430 bytes
Repository stars
19
License
MIT

Add, edit, or audit guidance docs. Default writes guidance for Claude (.claude/guidance/, Markdown, moflo universal rules). -h writes for human readers (docs/, lighter ruleset). --html emits HTML with a minimal default stylesheet instead of Markdown. -a audits the .claude/guidance/ directory.

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

# /guidance — Author and audit project guidance

Help the user write, edit, or audit guidance docs. By default the skill writes guidance **for Claude** into `.claude/guidance/` as Markdown and enforces the universal rules from `.claude/guidance/moflo-guidance-rules.md` (the single source of truth — do not paraphrase or duplicate). Flags switch the **audience** (`-h` → humans) and the **output format** (`--html` → HTML).

**Arguments:** $ARGUMENTS

## Modes and flags

| Flag | Effect |
|------|--------|
| (none) | Single-doc mode for **Claude** — Markdown, full universal rules, destination `.claude/guidance/<kebab-topic>.md` |
| `-h` | Switch audience to **humans** — Markdown, lighter human ruleset, destination `docs/<kebab-topic>.md` |
| `--html` | Emit **HTML** (with the minimal default stylesheet from Step 2.5) instead of Markdown. Composes with `-h`. |
| `-a` | **Audit** mode — two-pass triage of `.claude/guidance/` (Claude only). Cannot combine with `-h` or `--html`. |
| `<topic-or-path>` | Topic name (kebab-cased into the default destination) or an explicit file path that overrides the default destination. |

Combos:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add eric-cielo/moflo/guidance@sha256:00bc672bc135748c

The line at the top of this page pins the label git:20260807.4aab77c, 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_fum7tsrf32luqqoy.svg)](https://markdownregistry.com/a/art_fum7tsrf32luqqoy)

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

Versions

The registry has recorded 5 versions of this file, between May 6, 2026 and Aug 7, 2026, about one every 23 days.

versioncommittedcommitsizeaudit
git:20260807.4aab77c latest2026-08-07 4aab77c 19,430 BA view · diff
git:20260519.f29c7d32026-05-19 f29c7d3 19,123 BA view · diff
git:20260506.a2012282026-05-06 a201228 11,876 BA view · diff
git:20260506.8637cbf2026-05-06 8637cbf 11,887 BA view · diff
git:20260506.0a6659a2026-05-06 0a6659a 11,167 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 (19430 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

eric-cielo/moflo · 19 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fum7tsrf32luqqoy
GET https://markdownregistry.com/api/v1/resolve?ref=eric-cielo/moflo/guidance
GET https://markdownregistry.com/api/v1/blob/00bc672bc135748c2f6c07b702197156192b672b2d129e26f1dc7d1550b8f4dd

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 eric-cielo/moflo

commune SKILL.md skill
eric-cielo/moflo · .claude/skills/commune/SKILL.md · Turn a vague idea into a concrete, actionable spec through a short Socratic dialogue, then hand the result off to an…
git:20260719.f60a494 · audit A · 19 stars
connector-builder SKILL.md skill
eric-cielo/moflo · .claude/skills/connector-builder/SKILL.md · Scaffold new spell step commands and connectors. Use when building new step commands for spells or extending the spell…
git:20260804.cd68284 · audit A · 19 stars
distill SKILL.md skill
eric-cielo/moflo · .claude/skills/distill/SKILL.md · Alias for /flo-simplify — see that skill's description.
git:20260724.760eff1 · audit A · 19 stars
divine SKILL.md skill
eric-cielo/moflo · .claude/skills/divine/SKILL.md · Structured multi-hop web research with explicit confidence gating — plan the inquiry, search (WebSearch/WebFetch)…
git:20260524.7507419 · audit A · 19 stars
eldar SKILL.md skill
eric-cielo/moflo · .claude/skills/eldar/SKILL.md · Consult the Eldar — audit a project's moflo + Claude Code setup for portable, high-leverage gaps and guide remediation…
git:20260807.4aab77c · audit A · 19 stars
flo SKILL.md skill
eric-cielo/moflo · .claude/skills/fl/SKILL.md · MoFlo ticket spell - analyze and execute GitHub issues
git:20260810.06e5727 · audit A · 19 stars
flfl SKILL.md skill
eric-cielo/moflo · .claude/skills/flfl/SKILL.md · Run /fl on a ticket with moflo's three standing considerations loaded first — cross-platform (Rule #1), consumer blast…
git:20260813.995ce05 · audit A · 19 stars
flo-simplify SKILL.md skill
eric-cielo/moflo · .claude/skills/flo-simplify/SKILL.md · Review changed code for reuse, quality, and efficiency, then fix any issues found. Sizes review effort to the diff —…
git:20260804.a29c571 · audit A · 19 stars
flo SKILL.md skill
eric-cielo/moflo · .claude/skills/flo/SKILL.md · MoFlo ticket spell - analyze and execute GitHub issues
git:20260409.4930289 · audit A · 19 stars
healer SKILL.md skill
eric-cielo/moflo · .claude/skills/healer/SKILL.md · Run moflo's Healer (`flo healer`, alias for `flo doctor`) from inside the Claude session. Audit-only by default; pass…
git:20260513.68b5794 · audit A · 19 stars
luminarium SKILL.md skill
eric-cielo/moflo · .claude/skills/luminarium/SKILL.md · Print the localhost URL for The Luminarium — moflo's daemon dashboard — for the current project. Use when the user asks…
git:20260516.19edc0c · audit A · 19 stars
meditate SKILL.md skill
eric-cielo/moflo · .claude/skills/meditate/SKILL.md · Deliberate session retrospective — look back over what you just did, distill the durable, reusable lessons (not session…
git:20260525.9d1dfc0 · audit A · 19 stars

Every file in eric-cielo/moflo

Other files named guidance

guidance SKILL.md skill
orchestra-research/ai-research-skills · 16-prompt-engineering/guidance/SKILL.md · Control LLM output with regex and grammars, guarantee valid JSON/XML/code generation, enforce structured formats, and…
v1.0.0 · audit A · 13,718 stars
guidance SKILL.md skill
mateaix/mateclaw · mateclaw-server/src/main/resources/skills/guidance/SKILL.md · 回答用户关于 MateClaw 安装与配置的问题。优先定位并阅读本地文档,再提炼答案;文档不足时访问官网。
v1.2.0 · audit A · 1,169 stars
guidance SKILL.md skill
testdouble/han · han-plugin-builder/skills/guidance/SKILL.md · Authoritative guidance for building Claude Code skills, agents, and plugins, plus init and update steps that install…
git:20260818.55bdb1d · audit A · 319 stars

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