Index of every page on this site: llms.txt
All skills
onmax avatar

/visual-explanation

@aecfada
by Maxonmax/comark-ui43 stars
3
Run it yourself

Explains how something works with the smallest visual that answers the question, such as a sequence diagram, a call tree, a file tree, or a marked-up screenshot, placed beside the sentence it supports. Use when someone asks to be shown how a system, a flow, or a change works, or when the answer would otherwise take paragraphs of prose.

Use this Skill: https://skilld.dev/gh/onmax/comark-ui/visual-explanation

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesexample.md

≈269 tokens on demand. Your agent reads this file only when SKILL.md points to it.

How a Comark document becomes HTML

Parsing and rendering are two separate calls, and the plugins do their work in the first. That's why a block's problems are known before any HTML exists.

flowchart LR
  md[Markdown] --> tokens[Tokens]
  tokens --> tree[Node tree]
  tree --> doc[Nodes and issues]
  doc --> html[HTML]

A plugin can join at three points: its Markdown rules while the text becomes tokens, markdownItPost on the tokens, and post on the tree. The last arrow is the renderer, which only maps each node to a component.

In code, the diagram is three lines:

const document = await parseMarkdown(source, { plugins }); // <1>
if (document.meta.issues.length) refuse(document.meta.issues); // <2>
const html = await renderHtmlFromDocument(document, { components }); // <3>
  1. Every plugin runs here, in the order of plugins.
  2. Each issue is one sentence naming the block and the fix, so a host can refuse a document before it renders.
  3. Components only draw: screenshot maps to the figure's HTML, and nothing is parsed again.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts20d3 checks · Risk SAFE
  • Gen Agent Trust Hub20d

    The skill provides a set of instructions for generating visual explanations, such as diagrams and file trees, from source code and system data. It includes recommended commands for linting the output using the author's specific tooling. No security threats or malicious behaviors were detected.

  • Socket20d

    No alerts

  • Snyk20d

    Risk: LOW · No issues

Signed by skilld at aecfada. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 weeks ago

README badge

README badge for onmax/comark-ui/visual-explanation