Module skills 

The engine’s skill pack (ADR-0005 §2, ADR-0043): skills/<name>/SKILL.md folders in the open Agent Skills format, each with a worked example (example.ron, a script of contract commands) unless it waits for work still to come.

• Pack: the skills of a folder, by name, with their files: read from a checkout of the engine (Pack::read) or the one this shuyi embeds (Pack::embedded). shuyi new copies a pack’s skills into a new game’s .claude/skills/, all but the modules’ (shuyi add copies those);
• Frontmatter: what a SKILL.md says of itself, between its --- lines: the open format’s keys, and in metadata the pack’s own, version and waits_for;
• check: shuyi check-skills’ checks of a pack, each problem with its file and line: the frontmatter, the shuyi commands the skills name, the files they link, their length, what they wait for and their worked examples, and the problem codes they name.

Structs

Against

What check checks against, besides the pack.

Frontmatter

What a SKILL.md says of itself: the open Agent Skills format’s keys, and no others.

Pack

A skill pack: its skills, by name.

Problem

A problem check found: the file (from the pack’s folder), its line when it has one, and what is wrong.

Skill

A skill: its name (its folder’s) and its files.

Constants

EXAMPLE

A skill’s worked example, in its folder.

FILE

A skill’s own file, in its folder.

MAX_COMPATIBILITY

The longest a skill’s compatibility may be.

MAX_DESCRIPTION

The longest a skill’s description may be.

MAX_LINES

The most lines a SKILL.md may have: the open format keeps the rest in files it loads on demand.

MAX_NAME

The longest a skill’s name may be.

PACK

The skill pack, from the engine’s root.

Functions

check

Every problem of pack, checked against against, in order of skill and file: