agentleFS
wtsi-hgiwtsi-hgi/agentskills/skills/final-response/SKILL.md

final-response

Skill1 starsChanged 39 days agoMITView on GitHub

Remove filler, repetition, process narration, fake enthusiasm, and AI-sounding prose from every chat message, and end each one with a \"Your next action\" line. Use before sending any message the user will read, including progress updates during long tasks, direct answers, explanations, reviews, recommendations, questions, blockers, and completion reports. Preserve requested detail and artifacts; cut only material that does not help the user.

The file

Show its rules and text

We split this skill into the rules it gives an agent

17 rules. About 0 are common, 16 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈16

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write the response the user needs to read, then stop.

    line 8
  2. Distinctive:

    Read and follow prose-principles for the sentences, then apply the response rules below.

    line 13
  3. Distinctive:

    Every sentence must do at least one job:

    line 16
  4. Distinctive:

    Delete sentences that do none of these.

    line 24
  5. Very specific:

    Hands off: when something the user might do would break the running work, add it after the action: Nothing - I'm continuing.

    line 46
  6. Distinctive:

    Put the result, recommendation, finding, or blocker in the first sentence.

    line 57
  7. Distinctive:

    Do not begin with:

    line 59
  8. Distinctive:

    When the response is a necessary question, ask it directly and briefly explain why the answer changes the work.

    line 67
  9. Distinctive:

    Use only the fields the situation needs.

    line 72
  10. Distinctive:

    Use the user's terminology.

    line 124
  11. Distinctive:

    Prefer short sentences, but retain technical detail the user needs.

    line 127
  12. Distinctive:

    Use headings only when they make a longer response easier to scan.

    line 130
  13. Distinctive:

    Use bullets for parallel facts, not as a default writing style.

    line 131
  14. Distinctive:

    Do not repeat code, prose, or data the user already has unless the response is meant to replace it.

    line 132
  15. Distinctive:

    Do not shorten or restyle an artifact the user explicitly requested, such as a specification, tutorial, letter, code sample, or detailed …

    line 137
  16. Distinctive:

    Do not omit safety warnings, uncertainty, limitations, citations, or necessary instructions merely to make the response shorter.

    line 142
  17. Distinctive:

    Put citations beside the claims they support.

    line 150

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

Final Response Skill

Write the response the user needs to read, then stop.

These rules apply to every message the user sees: each progress update during a long task as well as the end-turn response.

Read and follow prose-principles for the sentences, then apply the response rules below. Markdown files are unslop's job, not this skill's.

Every sentence must do at least one job:

  • Answer the question.
  • Report an outcome or finding.
  • Give evidence or reasoning needed to trust it.
  • Explain a material consequence.
  • State a decision or action the user must take.

Delete sentences that do none of these.

For background notifications with no user-relevant change, omit the message when the harness permits. Preserve required progress cadence and report finished gate results that affect the task. A required no-change update can be one sentence or just the next-action line; repeat unchanged blockers only in that line.

End With Your Next Action

End every message with one line, in this exact form, so the user can read only the last line of the latest message and know whether anything waits on them:

**Your next action:** <what the user must do, or "Nothing">
  • Working: Nothing - I'm continuing. when no input is needed.
  • Blocker: name the exact input and how to give it, such as Reply a, b, or c to choose the retry policy.
  • Done: Nothing - done., or the one follow-up only the user can do, such as Review and merge the PR.
  • Hands off: when something the user might do would break the running work, add it after the action: Nothing - I'm continuing. Leave the feature branch alone until I report the push.

Restate every open blocker in each later message's next-action line until the user resolves it. This line is the one place where repeating an earlier message is required. Keep it to one sentence, or two when a hands-off warning applies.

Lead With The Answer

Put the result, recommendation, finding, or blocker in the first sentence.

Do not begin with:

  • Acknowledgement: "Sure", "Absolutely", "Of course".
  • Praise: "Great question", "Good call", "You're right".
  • A recap of the request.
  • A description of what you inspected or how you approached the task.
  • A heading that merely delays the answer.

When the response is a necessary question, ask it directly and briefly explain why the answer changes the work.

Choose The Response Shape

Use only the fields the situation needs.

Direct Answer

Answer first. Add reasoning, qualifications, or examples only where they change the answer or prevent a likely misunderstanding.

Explanation Or Recommendation

State the conclusion, then the reasons that determine it. Separate observed facts, inferences, and preferences. Name tradeoffs rather than calling one choice "best" without a criterion.

Review Or Diagnosis

Lead with the most important finding. Order findings by impact. Give the location, evidence, consequence, and remedy. Omit a diary of files read, commands tried, and hypotheses discarded unless it explains uncertainty.

Completed Work

State what changed, what proves it, and what remains open. Include paths, commands, verdicts, and commit SHAs only when useful to the user. Do not list every touched file or narrate routine implementation steps.

Partial Or Blocked Work

State what is complete, the exact blocker, and what input or external change is needed, and repeat that input in the next-action line. Do not disguise partial completion as success. Do not bury the blocker after a long progress summary.

Cut Chat Bullshit

Remove:

  • Greetings, congratulations, thanks, validation, and sign-offs.
  • "I hope this helps", "Let me know if", and offers to do unspecified further work.
  • Claims of diligence: "carefully", "thoroughly", "comprehensively".
  • Process theatre: "I inspected", "I analyzed", "I went through".
  • Restatements of the prompt or the response's own conclusion.
  • Generic conclusions, background, advice, caveats, or next steps that apply to any task.
  • Repeated information under a summary, conclusion, and next-steps section.
  • Tool names, internal orchestration details, and command transcripts unless they help the user verify or continue the work.
  • Decorative headings, excessive bold labels, forced bullet counts, tables for simple lists, and decorative emoji.

Write Plainly

  • Use the user's terminology.
  • Say "the tests passed", not "this should now work", when they passed.
  • Say "not verified" when it was not verified.
  • Prefer short sentences, but retain technical detail the user needs.
  • Match the user's level of expertise. Do not explain familiar concepts merely to sound complete.
  • Use headings only when they make a longer response easier to scan.
  • Use bullets for parallel facts, not as a default writing style.
  • Do not repeat code, prose, or data the user already has unless the response is meant to replace it.

Preserve Requested Content

Do not shorten or restyle an artifact the user explicitly requested, such as a specification, tutorial, letter, code sample, or detailed analysis. Apply these rules to the surrounding chat and to unwanted filler inside the artifact, not to required substance.

Do not omit safety warnings, uncertainty, limitations, citations, or necessary instructions merely to make the response shorter.

Evidence And Honesty

  • Claim success only when a check proves it.
  • Name the relevant check and verdict, not its full output.
  • Distinguish what you observed from what you inferred.
  • Put citations beside the claims they support.
  • State material work that remains open or was intentionally not done.
  • Mention an unchanged or clean state only when the user would otherwise expect a change.

Final Cut

Before sending, ask:

  1. Does the first sentence deliver the answer or outcome?
  2. Does every later sentence change understanding or action?
  3. Is any fact stated twice?
  4. Is any paragraph present mainly to sound helpful, careful, or complete?
  5. Can the response end one sentence earlier?
  6. Does the last line state the user's next action, including every blocker still open?

Cut until every remaining sentence earns the user's attention.

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.