agentleFS
robertbradley-ossrobertbradley-oss/skills/simplify-report/SKILL.md

simplify-report

Skill2 starsChanged 2 months agoMITView on GitHub

Explain supplied technical reports and already-produced tool output in clear everyday language while preserving the real outcome, severity, uncertainty, and actionable evidence. Use when the user asks what CI results, test summaries, audits, security findings, command output, status checks, or verification reports mean, including requests to simplify, decode, translate, summarize, or explain like they are five. Do not use for general prose editing, live diagnosis, or rerunning the underlying check.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read only the supplied report or output.

    line 12
  2. Distinctive:

    Check whether the evidence is incomplete, truncated, stale, or internally contradictory.

    line 14
  3. Distinctive:

    Follow a format the user explicitly requests.

    line 21
  4. Distinctive:

    Start with Bottom line. State the overall result and its practical meaning.

    line 23
  5. Distinctive:

    Keep the full answer inside the bottom line and selected questions.

    line 29
  6. Distinctive:

    Use calm, respectful, everyday language.

    line 33
  7. Distinctive:

    Keep actionable evidence such as a count, severity, filename, command, or product term when it changes understanding or next steps.

    line 39
  8. Distinctive:

    Do not assign blame or infer who caused a change.

    line 41
  9. Distinctive:

    Do not invent remediation.

    line 42

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Simplify Report

Explain supplied technical output so the user can quickly understand what happened, why it matters, and what to do first. Preserve the report's actual conclusion.

Workflow

  1. Read only the supplied report or output. Do not rerun tools, checks, or commands unless the user separately asks. If no report or result is available, ask the user to provide it and stop.
  2. Identify the overall outcome, meaningful successes, failures or warnings, uncertainty, and the best supported first action. Do not infer an overall pass from successful subchecks.
  3. Check whether the evidence is incomplete, truncated, stale, or internally contradictory. State any limitation that changes what can safely be concluded.
  4. Separate reported facts from interpretation. Do not present a likely explanation as confirmed or invent a remedy the evidence does not support.
  5. Translate jargon into ordinary language. Preserve counts, severity, verdicts, and names the user needs to understand or act; omit internal identifiers that do not help.
  6. Draft the answer using the format below, then verify that it matches the report. Correct any softened failure, hidden uncertainty, unsupported claim, or misleading overall status before responding.

Default output

Follow a format the user explicitly requests. Otherwise:

  1. Start with Bottom line. State the overall result and its practical meaning.
  2. Include every relevant question below. Omit a question only when its answer would add no useful information.
    • What worked? Explain the most meaningful successful parts without implying that they made the overall result pass.
    • What needs attention? Explain the failure, warning, uncertainty, or unexpected result and why it matters.
    • What should I do? Give the best first action supported by the report. When materially different choices exist, name the decision and briefly explain the options instead of choosing for the user.
  3. Use as many sentences as needed to make the explanation genuinely easy to understand. Prefer short sentences that explain one idea at a time, and stop when the user has enough context to understand the result and next step. Never omit a necessary explanation just to make the answer shorter.
  4. Keep the full answer inside the bottom line and selected questions. Do not add an opener, closing sentence, raw evidence dump, report path, taxonomy, or offer to explain more unless the user asks.

Writing rules

  • Use calm, respectful, everyday language. "Explain like I'm five" means assuming no technical background, using simpler words, and explaining unfamiliar ideas without baby talk.
  • Break complicated ideas into small steps. Use a familiar comparison only when it makes the meaning clearer.
  • Lead with practical meaning, not the report format or the analysis process.
  • Preserve severity. Never turn failed, blocked, incomplete, unsafe, or uncertain into passed or okay.
  • Preserve mixed outcomes explicitly. State both a successful component and a failed overall result when both are true.
  • Preserve uncertainty. If the evidence cannot establish something, say so plainly.
  • Keep actionable evidence such as a count, severity, filename, command, or product term when it changes understanding or next steps.
  • Distinguish a product failure from a check, tool, or environment failure.
  • Do not assign blame or infer who caused a change.
  • Do not invent remediation. If the report supports no safe next action, say what information or decision is needed first.
  • For medical, legal, financial, privacy, or security findings, simplify the language without softening risks or removing necessary cautions.

Example

Input meaning: tests passed, two task files stayed in scope, one unrelated file changed, and the overall scope check failed.

Output:

Bottom line. The work passed its tests, but the overall scope check failed because an unrelated configuration file also changed.

What worked? The tests passed, and the two task files stayed in the agreed area.

What needs attention? config/prod.json changed outside that area. That extra change is why the overall check failed.

What should I do? Review the config change and decide whether to remove it or explicitly include it in the task.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.