Catalog
Yeachan-Heo/in-your-own-words

Yeachan-Heo

in-your-own-words

Play back the goal, the problem, and the success check in your own words when a brief is genuinely ambiguous — vague, contested, or leaving real forks open — so misunderstanding is caught cheaply. Not for well-specified or routine tasks.

v1.0LATEST
NewUpdated Nov 8, 2026

In Your Own Words

Before the first tool call on genuinely ambiguous work — a brief that is vague, contested, or leaves real forks open — say back what you understood — in your words, not the user's phrasing echoed. Misunderstanding caught now costs a sentence; caught after execution it costs the work. A well-specified brief needs no playback: start, and report what you did.

The playback

Three parts, plain language:

  1. The goal: what the user will have when this is done.
  2. The problem (if any): what stands in the way, as you understand it.
  3. The success check: how we will know it worked.

Then one line: "Right? Correct me where I drifted." — and stop for the answer on risky work; proceed-and-report on clearly reversible work (principles skill, Never block on the human).

Rules

  • Playback is a paraphrase, not a copy: if you can only repeat the brief, you have not understood it yet.
  • Name your assumptions inline ("I am assuming staging, not production").
  • Disagreement between your playback and the brief is the point — surface it, do not smooth it.
Files1
1 files · 1.0 KB

Select a file to preview

Overall Score

87/100

Grade

A

Excellent

Grades are signals, not a certification. Always review a skill yourself before use.

Safety

95

Quality

88

Clarity

92

Completeness

78

Summary

This skill teaches an AI agent to perform reflective clarification on ambiguous work briefs by playing back the goal, problem, and success criteria in the agent's own words before beginning work. It is a meta-skill focused on risk mitigation through early-stage communication and understanding validation, not a tool that executes code or modifies systems.

Detected Capabilities

structured reasoningparaphrasing and rephrasingassumption naminggoal/problem/success extraction

Trigger Keywords

Phrases that agents use to match this skill to user intent.

clarify ambiguous briefvalidate requirementssurface assumptionsparaphrase goalcatch misunderstanding early

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.com

Use Cases

  • Clarify vague or contested project requirements before starting
  • Surface hidden assumptions in ambiguous briefs through paraphrasing
  • Validate understanding of success criteria with stakeholders early
  • Prevent rework by catching misalignment before execution begins
  • Guide agents to distinguish between well-specified tasks (no playback needed) and genuinely ambiguous ones

Quality Notes

  • Skill is exceptionally clear and concise — three components and two rules fit one page without clutter
  • Directly addresses a real problem: preventing costly misunderstandings by catching them at clarification stage, not after work
  • Strong pedagogical focus: rule against mere echo ('if you can only repeat the brief, you have not understood it yet') trains the agent to genuinely understand
  • Rule to surface disagreement rather than smooth it is excellent — builds conflict resolution into the process
  • Playback model is practical and easy to follow: goal, problem, success check, then ask for correction
  • References to domain-specific aliases (pstack, Lauren Tan, Michael Denyer) show lineage and credibility
  • Caveat 'Well-specified brief needs no playback: start, and report what you did' prevents unnecessary overhead
  • Assumption inline naming is concrete and actionable
  • One minor clarity gap: no explicit guidance on 'how risky is risky?' — when to block for answer vs. proceed-and-report could be clearer (though 'principles' skill is referenced as guidance)
Model: claude-haiku-4-5-20251001Analyzed: Nov 8, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use Yeachan-Heo/in-your-own-words in your dev environment

Command Palette

Search for a command to run...