agentleFS
SecurityMindedSolutionsSecurityMindedSolutions/ai-skills/skills/communication/ugh/SKILL.md

ugh

Skill2 starsChanged 42 days agoMITView on GitHub

One breath, the tldr. Say the last message in a single sentence, plus a You line only when something actually needs me. The shortest summary, for when I am tired.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Write the You: label in bold - You: - and the urgency prefix on each bullet too.

    line 22
  2. Distinctive:

    No file paths, tool names, commands or shop talk.

    line 28
  3. Very specific:

    When every ask shares one urgency, say it once on the You: line and drop the per-bullet prefixes.

    line 64
  4. Distinctive:

    Keep the ask, and never invent one.

    line 76
  5. Distinctive:

    No headings, tables or code, and no bullets except the multiple-ask case above.

    line 81
  6. Distinctive:

    If the message was already this short, say so and leave it alone.

    line 83

≈ “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

Say your last message again for someone who is tired. They have nine things open and need to know whether this one wants them.

Shape

One sentence for where things stand.

Then, only if the source asked them for something, a second line labelled You: carrying the ask and how soon it is needed.

No You: line when there is no ask, and never an empty one - its absence is the message. Two lines is the ceiling, before the bullets below.

Write the You: label in bold - **You:** - and the urgency prefix on each bullet too. The terminal renders markdown, so bold is the only emphasis available, and the labels are what makes this scannable rather than readable.

Words

No file paths, tool names, commands or shop talk. Say what a thing does, not what it is called. Short common words: use, not utilize. Wrong, not incorrect. Left out, not omitted.

One exception, and only one: keep the pull request or ticket the message is about. Once, as a short link - [#1733](the url) - on the thing it names. It does not count against the shape.

The ask

An ask is something only they can do: a decision, an approval, an action, an answer. "I will ping you when it lands" is not an ask.

"Nothing" and an ask cannot share a line. If there is an ask, it comes first. Say how soon it is needed after it, never before.

One ask stays inline. Two or more become bullets, one per ask, so the count is visible before a word is read. Never merge two asks into one, and never replace them with a count - a counted ask is a lost ask.

Order the bullets by what is needed soonest.

Each bullet leads with its urgency, so the reader can find tonight's work without reading the topics:

You:
- Before I merge: both changes now, or hold the app side until after the campaign?
- No rush: file a check that catches the next one?

The prefix comes only from what the source said - a deadline it named, or work it said this blocks. If the source said nothing about timing for an ask, that bullet starts with the ask itself and carries no prefix. Never invent urgency, and never invent a deadline.

When every ask shares one urgency, say it once on the You: line and drop the per-bullet prefixes. A prefix repeated on every bullet is not information, and "Also before starting" is a clumsy way of saying "same as the one above":

You: both before any work starts.
- Cross-agent for all nine, which means ...
- Does your local copy stay the master ...

Faithfulness

Keep the ask, and never invent one. Add nothing the source did not say, and keep its hedges: if the source said no problems were found, that does not become correct; if it said something is unproven, it stays unproven. Keep every number the source gave.

No headings, tables or code, and no bullets except the multiple-ask case above.

If the message was already this short, say so and leave it alone.


Sibling: /huh (now, next, you) shares everything above except the Shape section. A rule changed here belongs there too.

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.