Skip to content

rse/ase / plugin/skills/ase-sync-export

ase-sync-export

Verified

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.

FileKindSize
SKILL.mdskill md5.1 KB
help.mdmarkdown2.7 KB

##  NAME

`ase-sync-export` - Export Specification into Rendered Files

##  SYNOPSIS

`ase-sync-export`
    [`--help`|`-h`]
    [`--output`|`-o` *output*[,...]]

##  DESCRIPTION

The `ase-sync-export` skill exports the `SPEC` artifact set -- the
*SpecBook*-based specification of the project, located via the
`project.artifact.spec.basedir` configuration -- into *derived*,
ready-to-consume renderings. The specification is first validated
against the *SpecBook* schema configuration; on any error diagnostic
the skill errors out and exports nothing, as a partial or invalid
specification must never be rendered. Otherwise every requested
*output* is rendered via the *SpecBook* export.

Each *output* is an `[<format>:]<file>` entry, where the format is one
of `json`, `json5`, `yaml`, `toon` (the specification object model),
`html` (self-contained single document with table of contents, full-text
search, and light/dark theme), `pdf` (paginated print document), or `md`
(normalized single Markdown document). The format is inferred from the
filename extension unless it is explicitly given as a prefix. The
standard output sentinel `-` is not supported.

The `pdf` format is the only one with an external prerequisite: it
prints the rendering through a Chromium-class browser. Neither `npm
install -g @rse/ase` nor `ase setup install` downloads one, so unless a
*Google Chrome* is installed system-wide, the Playwright Chromium has to
be fetched once via `npx playwright install chromium`. Without any such
browser the export fails up-front, before the specification is parsed,
and reports that very command; when it falls back onto a system-installed
*Google Chrome*, the skill reports this as an environment notice.

##  OPTIONS

-   `--output`|`-o` *output*[,...]:
    The comma-separated list of `[<format>:]<file>` entries to render,
    with each file path relative to the project root. Defaults to the
    single HTML rendering `index.html` inside the `SPEC` base directory
    (e.g. `docs/specbook/index.html`).

##  SCENARIOS

-   You want the specification rendered as HTML, PDF, Markdown, or JSON
-   You want a shareable, ready-to-consume export of the `SPEC` artifacts
-   You want the specification validated and then materialized into files

##  EXAMPLES

Export the specification to its default HTML rendering:

```text
❯ /ase-sync-export
```

Export the specification as HTML and PDF:

```text
❯ /ase-sync-export -o docs/spec.html,docs/spec.pdf
```

Export the specification object model as YAML into a file without a
telling extension:

```text
❯ /ase-sync-export -o yaml:docs/spec.model
```

##  SEE ALSO

[`ase-sync-reconcile`](../ase-sync-reconcile/help.md),
[`ase-sync-import`](../ase-sync-import/help.md).
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall