agentleFS
dip497dip497/onmywatch/skills/show-me/SKILL.md

show-me

Skill1 starsChanged 19 days agoMITView on GitHub

Show the current topic instead of explaining it. "/show-me" draws the smallest picture in the chat, and a page if it needs a real diagram. "/show-me sheet" or "/show-me share" builds one HTML sheet of lettered panels, to open or publish. "/show-me flow" maps what was built as a user flow: screens, decisions, error paths and review marks.

79 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use maintain-formal-verification-skill, create-formal-verification-skill and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • TheOnlyFusionCubeSkill

    maintain-formal-verification-skill

    Bring a project's formal verification back in line with the code after the code changes: find the commits that touched verified code, update the model, harness, or properties to describe the code as it is now, rerun, and say whether each failure is drift in the verification or a bug in the code. Use for /maintain-formal-verification-skill, \"is the model still true to the code\", or after merges and refactors that touched verified code without rechecking it.

    Also in 4 projects that use this

  • TheOnlyFusionCubeSkill

    create-formal-verification-skill

    Generate a project-local skill that formally verifies the code where a bug costs the most and tests reach the least, in any language, with whichever verification tool fits. Use for /create-formal-verification-skill, \"model-check this race\", \"prove this invariant\", or when concurrency, retries, state machines, parsers, or unsafe code need more than tests.

    Also in 4 projects that use this

  • AnthropicSkill

    eli5

    Explain a topic like I'm a 5 year old. Use when the user types /eli5 <topic> or asks for a dead-simple picture explainer of how something works.

    Also in 10 projects that use this

  • drafaelSkill

    in-your-own-words

    Restate the user's goals and the problem they are trying to solve to check understanding. Manual invocation only; use when the user explicitly invokes in-your-own-words or requests this understanding check. Do not solve the task or rewrite the assistant's last answer.

    Also in 4 projects that use this

  • jaydubya818Skill

    create-verification-skill

    Use when a repository needs a repeatable driver that proves real UI, CLI, or service behavior.

    Also in 8 projects that use this

  • jaydubya818Skill

    maintain-verification-skill

    Use when a project's verification driver or feature map may be stale.

    Also in 7 projects that use this

  • +1 more from jaydubya818

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 73 edited versions we read keep these.

  • 4

    Distinctive

    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. Very specific:

    If the first word is sheet, flow or share, it picks the page and the rest is the topic.

    line 14
  2. Distinctive:

    Stop at the first level that makes it clear.

    line 18
  3. Distinctive:

    Keep only what answers the question.

    line 41
  4. Distinctive:

    Write about 80% of the way to ASD-STE100 Simplified Technical English.

    line 45
  5. Distinctive:

    Every line, mark and colour must carry meaning.

    line 51

“Common” is measured: kept by at least 6 in 10 of the 73 edited versions of this file we could read. “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

show-me

Show the idea. The picture comes first.

Arguments: $ARGUMENTS

If the first word is sheet, flow or share, it picks the page and the rest is the topic. Otherwise the arguments are the topic, or the current conversation if there are none, and you pick the level.

Pick the level

Stop at the first level that makes it clear. Read only the file your level names, from this skill's folder.

LevelUse whenFormRead next
WordsOne fact or one ruleTwo or three sentencesNothing
Text pictureLogic, one call path, files, a changeA code block in the chatNothing
Small diagramUp to 4 parts in one lineA text box diagram in a code blockNothing
Sheet5 or more parts talking, branches or loops, a comparison, or sheet or shareOne HTML page of lettered panels, opened for the readerplaybooks/sheet.md
WalkthroughHow something works and why, with more than one viewOne HTML page with tabs and guided stepsplaybooks/walkthrough.md
FlowA user journey through UI states, or flowOne HTML map of screens and decisionsplaybooks/flow.md

Never put Mermaid, SVG or HTML in the chat. The terminal shows them as source code, not as a picture. If a text picture does not read correctly in a monospace code block, build a page.

Text pictures

Pick the one shape that fits. Use a second only if it shows something the first cannot.

  • Logic as pseudocode: on(save) / if unchanged / return cached.
  • Runtime flow as a call tree, indented by who calls whom.
  • UI as a component tree, with the state and the file of each part.
  • Ownership as a shallow file tree with one comment per folder.
  • A change as a diff of any shape above: + new, - gone.

Keep only what answers the question.

Writing

Write about 80% of the way to ASD-STE100 Simplified Technical English. Code, quotes and UI labels stay as they are.

  • One topic per sentence. At most 20 words for an instruction, 25 for a description.
  • Active voice, simple tenses, short common words. No idioms, metaphors or jokes.
  • One name for one thing. Names from the code stay exact.

Every line, mark and colour must carry meaning. Never draw boxes for decoration.

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.