ase-sync-export

SkillDocs & knowledge

Export the SpecBook-based specification (SPEC) into ready-to-consume renderings like HTML, PDF, normalized Markdown, or JSON. Use when the user wants to "export", "render", or "materialize" the specification.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ase-sync-export skill

What this skill tells your AI

The instructions your AI receives, as published by rse/ase in plugin/skills/ase-sync-export/SKILL.md and read by ahel’s review.

@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md

$ARGUMENTS

@${CLAUDE_SKILL_DIR}/../../meta/ase-format-meta.md

Procedure

    1. Parse as the comma-separated list of [<format>:]<file> entries, with one of json, json5, yaml, toon, html, pdf, or md, and a project-relative output file path. Trim every parsed entry. Do not output anything.

    2. Determine the default output by calling the ase_artifact_name(filename: "index.html", kind: "spec") tool of the ase MCP server and set to the single entry of its returned name. Do not output anything.

    3. If any entry in is - (the standard output sentinel), only output the following and then immediately STOP processing the entire current skill:

    4. Report the resolved outputs with the following :

    1. Call the ase_specbook_lint() tool of the ase MCP server once and read its returned diagnostics array of { file, line, column, severity, message } objects, reduced to those entries whose is error, as only those make the export fail. Do not output anything.

    2. Only output the following (listing one bullet line per diagnostic), give the closing hint by expanding the <ase-tpl-hint/> below it, and then immediately STOP processing the entire current skill:

      • <file/>:<line/>:<column/>: [...]
    1. For each in , call the ase_specbook_export(output: "<output/>") tool of the ase MCP server, which infers the format from the [<format>:]<file> entry, writes the rendering to the file, and returns a confirmation text carrying the written byte size plus a notices array of environment notices. Set to the distinct notices of all calls. Do not output anything.

    2. Report the exported files with the following , listing one bullet line per written file (with its project-relative path and the format and the byte size):

      • <file/>: [...]
    3. Report the environment notices verbatim with the following , listing one bullet line per notice:

      [...]

    4. Finally, give the closing hints by expanding the following (which, depending on the configured , may each expand into nothing and hence emit no output at all):

Signals

GitHub stars
52
Forks
5
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ase-sync-export
Source
github.com/rse/ase