task-brief SKILL.md skillA

task-brief from moonlight-lupin/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add moonlight-lupin/agent-skills/task-brief@v1.1.0

Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
moonlight-lupin/agent-skills
Path
productivity/task-brief/SKILL.md
Versions recorded
6
Latest version
v1.1.0, committed Oct 5, 2026
First version recorded
Jul 9, 2026
Size
9,660 bytes
Repository stars
119
License
MIT

Use when the user says "brief this task", "scope this properly", "what do you need from me", "improve my prompt", "help me get better output", or hands over a SUBSTANTIAL task — multi-step, multi-document, or a deliverable someone else will read — as a thin one-line request. Compile a task brief BEFORE starting substantial work — pin down the goal (what "done" looks like), context, constraints (standing rules included automatically), and tooling — confirm with the user, then execute against it.

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

# Task Brief

Thin requests are the biggest cause of mediocre agent output: the agent guesses the
deliverable, the audience and the guardrails, and the user only discovers the
misreading after the work is done. This skill moves that discovery to the **cheapest
possible point** — before the work starts — by having the agent compile a short
**task brief**, show it, and only then execute. The user never has to write a better
prompt; the agent does the structuring.

## When to run it — and when not to

**Run it when:**
- the user explicitly asks ("brief this first", "make sure you understand before starting"); or
- the task is **substantial** — multi-step, multi-document, or a deliverable someone
  else will read (a memo, a report, a dashboard, a document batch) — and the request
  is thin or ambiguous enough that two reasonable readings would produce different work.

**Skip it** (just do the task) for quick factual questions, single-step edits, and
requests already crisp enough to act on. A brief on a trivial ask is friction, not
quality — proportionality is part of the skill. When in doubt, a one-line
restatement of the goal ("I'll read this as X — say if not") beats a full brief.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add moonlight-lupin/agent-skills/task-brief@sha256:a6f35022a3100d3d

The line at the top of this page pins the label v1.1.0, 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_jen4v3plwrss5xu3.svg)](https://markdownregistry.com/a/art_jen4v3plwrss5xu3)

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

Versions

The registry has recorded 6 versions of this file, between Jul 9, 2026 and Oct 5, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-10-05 a776a92 9,660 BA view · diff
v1.1.02026-09-12 e9befbf 9,665 BA view · diff
v1.1.02026-09-12 7e8bf99 11,016 BA view · diff
v1.1.02026-09-12 12a1517 11,299 BA view · diff
v1.0.02026-08-13 090474f 8,974 BA view · diff
v1.0.02026-07-09 4bda4cd 8,958 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 (9660 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

moonlight-lupin/agent-skills · 119 stars · license MIT · pushed 2026-10-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jen4v3plwrss5xu3
GET https://markdownregistry.com/api/v1/resolve?ref=moonlight-lupin/agent-skills/task-brief
GET https://markdownregistry.com/api/v1/blob/a6f35022a3100d3da6cd15bf5d649c1632f10e01f538241ebc8fcd2d7c6d85eb

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 moonlight-lupin/agent-skills

claude-plugin-converter SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/claude-plugin-converter/SKILL.md · Use when converting Claude Code plugins into self-contained Hermes plugins — discovery analysis then full conversion.
v1.0.0 · audit A · 119 stars
hermes-onboarding SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/hermes-onboarding/SKILL.md · Use when onboarding a new customer — configure gateway, dashboard, memory, services for production.
v1.3.0 · audit B · 119 stars
input-token-overheads SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/input-token-overheads/SKILL.md · Use when the context window fills too fast, per-turn input token cost is too high, or the aggregate input token bill…
v1.9.0 · audit A · 119 stars
log-analyzer SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/log-analyzer/SKILL.md · Use when parsing agent log files to identify error patterns, rate limit hits, timeout clusters, tool failures, and…
v1.1.0 · audit A · 119 stars
operator-brain SKILL.md skill
moonlight-lupin/agent-skills · agent-ops/operator-brain/SKILL.md · Use when communicating, deciding, or reporting as a senior operator — 8 behavioral modules from Anthropic's Fable…
v1.1.0 · audit A · 119 stars
clips-studio SKILL.md skill
moonlight-lupin/agent-skills · creative/clips-studio/SKILL.md · Use when the user wants to "make a video/clip", "generate a video from text", "animate this image/photo", "create a…
v1.2.2 · audit A · 119 stars
image-studio SKILL.md skill
moonlight-lupin/agent-skills · creative/image-studio/SKILL.md · Use when the user wants image generation or editing through the local fal.ai three-stage studio workflow — brainstorm a…
v1.3.2 · audit A · 119 stars
pexels-stock-photos SKILL.md skill
moonlight-lupin/agent-skills · creative/pexels-stock-photos/SKILL.md · Use when the user wants a REAL photo — 'find a photo of X', 'search for pictures of Y', 'stock image of Z', 'I need a…
v1.0.0 · audit A · 119 stars
disk-cleanup SKILL.md skill
moonlight-lupin/agent-skills · devops/disk-cleanup/SKILL.md · Use when df says disk is above 80% full or the user wants to reclaim storage space on a VM.
v1.3.1 · audit B · 119 stars
model-compare SKILL.md skill
moonlight-lupin/agent-skills · mlops/model-compare/SKILL.md · Blind side-by-side multi-model comparison. Send one prompt to 2-4 models simultaneously, present responses anonymously…
v1.2.0 · audit A · 119 stars
contrastive-refinement SKILL.md skill
moonlight-lupin/agent-skills · plugins/contrastive-advisor/skills/contrastive-refinement/SKILL.md · Use when a skill or harness edit needs evidence before it lands — probe candidates on the same task, compose from…
v0.2.0 · audit A · 119 stars
grill SKILL.md skill
moonlight-lupin/agent-skills · plugins/dev-pipeline/skills/grill/SKILL.md · Use when a plan is fuzzy and needs hardening before a spec — decision-tree grilling in frontier rounds, every open…
v1.1.0 · audit A · 119 stars

Every file in moonlight-lupin/agent-skills

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