clarity SKILL.md skillA

clarity from getedgehq/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add getedgehq/skills/clarity@v0.2.1

Pins v0.2.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
getedgehq/skills
Path
clarity/SKILL.md
Versions recorded
1
Latest version
v0.2.1, committed Oct 22, 2026
Size
7,805 bytes
Repository stars
4
License
Apache-2.0

Draft, rewrite, or review reader-facing prose so it is specific, useful, and recognizably the author's without inventing facts or performing humanness. Use for essays, articles, newsletters, documentation, talks, launch copy, and other important prose that feels generic, hollow, or AI-shaped. Supports co-write, rewrite, review, and lint modes.

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

# Clarity

Good prose gives a particular reader something worth carrying away. Generic model prose often
fails before style enters the picture: it has no specific source, judgment, mechanism, image, or
experience behind it. Fix that first.

Do not optimize for an AI detector or promise a detector result. Do not manufacture typos,
slang, anecdotes, uncertainty, opinions, or awkwardness. The goal is better writing with honest
provenance.

## Choose a mode

An explicit mode word wins:

```txt
interview | write | draft | new     Co-write from the author's supplied language.
rewrite | edit | fix | humanize     Rewrite an existing draft.
review | critique | check           Critique without rewriting or changing files.
lint | stats                        Run diagnostics without changing prose.
```

Without a mode, infer from the request. Ask only when the user could reasonably mean either a
review or a rewrite.

Load only the reference the mode needs:

```txt
Co-write    references/interview.md
Rewrite     references/edit.md
Review      references/review.md, then references/edit.md as a pattern reference
Lint        scripts/strip_markdown.py and scripts/prose_stats.py
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add getedgehq/skills/clarity@sha256:00a3a71bcc60a565

The line at the top of this page pins the label v0.2.1, 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_v7t6ff2uckxstdzw.svg)](https://markdownregistry.com/a/art_v7t6ff2uckxstdzw)

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

Versions

The registry has recorded 1 version of this file, committed on Oct 22, 2026.

versioncommittedcommitsizeaudit
v0.2.1 latest2026-10-22 19f24b4 7,805 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 (7805 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

getedgehq/skills · 4 stars · license Apache-2.0 · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_v7t6ff2uckxstdzw
GET https://markdownregistry.com/api/v1/resolve?ref=getedgehq/skills/clarity
GET https://markdownregistry.com/api/v1/blob/00a3a71bcc60a565f5c39bb95f46440e80025f4842ebbc49b1d062a369f4c5d5

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

abel-sell-the-alpha SKILL.md skill
getedgehq/skills · abel-sell-the-alpha/SKILL.md · Build an account-specific enterprise sales brief using Jen Abel's buyer-advantage method. Use for founder-led…
git:20261002.d5668a9 · audit A · 4 stars
agent-governance-gap-analysis SKILL.md skill
getedgehq/skills · agent-governance-gap-analysis/SKILL.md · Score an organisation's AI agent governance against 25 technical checks across 7 dimensions — agent inventory…
git:20260928.4a8b17a · audit A · 4 stars
agent-infra-fixer SKILL.md skill
getedgehq/skills · agent-infra-fixer/SKILL.md · Fix the agent's own environment when skill-miner surfaces infra-class failures - broken or over-broad hooks…
git:20260929.d19e06d · audit A · 4 stars
agent-receipt SKILL.md skill
getedgehq/skills · agent-receipt/SKILL.md · Create a compact, evidence-backed proof-of-work receipt for a completed AI agent run. Use when the user wants to…
git:20260920.deb764a · audit A · 4 stars
agent-skills-gap SKILL.md skill
getedgehq/skills · agent-skills-gap/SKILL.md · Analyze Claude or Codex session logs or pasted prompts to identify evidenced strengths, weak task categories, a…
git:20260920.a474e57 · audit A · 4 stars
ai-dna SKILL.md skill
getedgehq/skills · ai-dna/SKILL.md · Turn your own local ChatGPT, Claude Code, and Codex conversation history into a 4:5 AI DNA helix still and 12-second…
git:20260929.4160913 · audit A · 4 stars
ai-festival-poster SKILL.md skill
getedgehq/skills · ai-festival-poster/SKILL.md · Turn someone's real AI usage into a desert festival lineup poster, painted in Python. Scans local Claude Code and Codex…
git:20260924.9d39be8 · audit A · 4 stars
ai-team SKILL.md skill
getedgehq/skills · ai-team/SKILL.md · Set up a small AI team in Claude Code or Codex: a Chief of Staff that routes work on a board, role agents (product…
git:20261009.f111569 · audit A · 4 stars
albro-founder-brand SKILL.md skill
getedgehq/skills · albro-founder-brand/SKILL.md · Build a buyer-focused founder narrative, content plan, distribution routine, and revenue hook using Scott Albro's…
git:20261002.d5668a9 · audit A · 4 stars
anatomy SKILL.md skill
getedgehq/skills · anatomy/SKILL.md · Build crafted, highly detailed, interactive isometric SVG figures that explain a technical idea as a real physical…
git:20261022.d91e25b · audit A · 4 stars
andy-raskin-strategic-narrative SKILL.md skill
getedgehq/skills · andy-raskin-strategic-narrative/SKILL.md · Build or review a buyer-centered strategic narrative using Andy Raskin's public method. Use for sales or investor deck…
git:20261002.d5668a9 · audit A · 4 stars
ar-aging-and-cash-application SKILL.md skill
getedgehq/skills · ar-aging-and-cash-application/SKILL.md · Build an accounts receivable aging report and apply incoming cash to invoices. Covers aging buckets, due dates from…
git:20261005.43cc1a8 · audit A · 4 stars

Every file in getedgehq/skills

Other files named clarity

clarity SKILL.md skill
rogue-dev-studio/ai-agents-rogue · skills/clarity/SKILL.md · Canonical spec and requirements skill: 5-phase clarity workflow plus Spec-Kit / markdown-agent spec patterns. Use for…
git:20260731.ddb8838 · audit A · 2 stars

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