yon-read

Interpret and explain YON documents, tags, and records in plain English.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill yon-read-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yon-read
Source: https://github.com/allemaar/open-skills/tree/main/skills/yon-read
Command: npx skills add https://github.com/allemaar/open-skills --skill yon-read-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? YON (YounndAI Object Notation) files are dense, line-oriented records that are hard to understand at a glance. This Skill reads any .yon file or YON snippet and translates its tags, rules, workflows, and references into clear, section-by-section explanations. ## Core Features & Use Cases - Document Interpretation: Parses @DOC headers, sections, and profiles to explain what a YON document is, its kind, and its intent. - Tag-by-Tag Explanation: Decodes all 72 tags across Core, Cognition, and Agent layers, including rules with severity levels, workflow steps, and provenance stamps. - Reference Resolution: Follows reference tokens (rid:, block:, cfg:, agent:) to explain how records connect to each other. - Use Case: A teammate shares a .yon rules file for API safety. Ask the agent to explain it, and receive a plain-English summary of each section, every MUST/SHOULD rule, and the rate-limit mappings. ## Quick Start Ask the agent to read the attached .yon file and explain what each section and rule means in plain English.

Frequently Asked Questions about yon-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and understand a YON file?

Start with the @DOC header to learn the document's kind, profile, and format, then walk each @SEC section and interpret records by tag. This Skill translates tags like @RULE, @STEP, and @MAP into plain-English explanations grouped by section.

What do @RULE severity levels mean in YON?

YON rules carry a lvl field with values MUST, MUST_NOT, SHOULD, SHOULD_NOT, or MAY, indicating how binding the constraint is. When explaining a document, mandatory rules are stated prominently while SHOULD rules are presented as recommendations.

Can YON Layer 4 agent records be executed anywhere?

Reading and interpreting Layer 4 records like @AGENT, @STREAM, and @SIGNAL is always supported, but executing @AGENT-routed dispatch depends on the host runtime. Claude Code supports it via the Agent tool; other runtimes vary.

When should I use yon-read versus yon-write?

Use yon-read when you want to interpret, summarize, or explain existing YON content. Use yon-write when you want to create, edit, convert, or extend YON documents. Generic questions about the format with no content present trigger neither.

What is the difference between trust and confidence fields in YON?

Trust measures the reliability of the source that produced a record, while confidence measures the certainty of the content itself. Both range from 0.0 to 1.0 and must not be conflated when interpreting cognition or memory records.