yon-write

Convert prose, rules, and workflows into valid YON v2.0 records.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing YON (YounndAI Object Notation) documents by hand is error-prone: strict separator rules, required fields per tag, profile and format choices, and block encoding constraints all must be satisfied for output to parse. This Skill guides an agent to create, generate, or convert content into syntactically valid, roundtrip-safe YON. ## Core Features & Use Cases - Prose-to-YON Conversion: Maps natural language constraints ("must", "never", "should") to @RULE levels while preserving hedging and uncertainty verbatim. - Decision Gates: Structured selection of profile (core, decl, exec, audit, cognitive, agent), format (canon, min, ultra), and document kind before writing. - Validation Checklist: Built-in verification of @DOC placement, @BEGIN/@END pairing, @MAP quoting, and required fields per tag. - Use Case: Convert a messy prose API policy ("all calls must have auth tokens, premium users get 500/min") into a parseable kind=rule YON document with @RULE, @MAP, and @STAMP records. ## Quick Start Convert this rate limiting policy into a YON rule document using the decl profile and min format.

Frequently Asked Questions about yon-write

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

FAQPage Schema
How do I convert prose or text into YON format?

Detect section boundaries from topic shifts, map constraint words to rule levels ("must" to MUST, "never" to MUST_NOT, "should" to SHOULD), move purpose statements to @INTENT, and drop conversational noise. Preserve hedging like "probably" verbatim rather than resolving it to confidence values.

What are the required fields for YON tags like @RULE and @DOC?

@DOC requires ver, id, and title and must be the first non-comment record. @RULE requires lvl (MUST/MUST_NOT/SHOULD/SHOULD_NOT/MAY), when, and then. Other tags like @STEP need rid, n:int, and op; @MAP needs name and pairs with both sides quoted.

When should I not use YON format?

Avoid YON for API responses, config files, database records, simple key-value data, and messages under roughly 340 tokens, where JSON, TOML, or plain text are cheaper. YON fits system prompts, agent instructions, policies, workflows, and provenance tracking where intent and audit travel together.

Which YON profile and format should I choose?

Choose profile by content: decl for rules and schemas, exec for workflows, audit for provenance, cognitive for thought chains, agent for multi-agent systems, core for basic documents. Use fmt=min for LLM pipelines (the recommended default), canon for human-readable docs, and ultra for cost-critical transport.

Why does my YON block encoding fail validation?

Every @BEGIN must include mime= and a boundary of 8 or more characters, and each @END must repeat the same TAG and boundary exactly. When multiple blocks exist, each needs a unique id= or the parser raises a duplicate ID error. Blocks must not nest.