openpress-create-pages

skills/openpress-create-pages/SKILL.md

Step 1: Environment Check

Before starting, please ensure your environment has Node.js 20 or newer installed, along with npm and npx.

Step 2: Initialize Workspace (For New Projects Only)

If you are creating a completely new project environment, run this first:

npm create @open-press@latest <your-project-name>

If you are adding a document to an existing project, skip this step.

Step 3: Generate Page Structure with the Skill

Call the Agent or run the openpress-create-pages workflow. Please provide the following information to generate the structure:

• Artifact type (e.g., report, proposal)
• Target audience and title
• Page size (e.g., a4)

This operation will create a Press Tree containing MDX sources, page components, and the first topic file.

For example, the generated Press structure will look like this:

<Press
  slug="proposal"
  title="Investor Proposal"
  page="a4"
  sources={[
    mdxSource({ id: "proposal", preset: "section-folders", root: "proposal/chapters" }),
  ]}
>
  <Cover />
  <Toc source="proposal" maxLevel={2} />
  <Sections source="proposal" />
  <BackCover />
</Press>

Step 4: Validate Structure

Once the structure is generated, please run the build command to ensure all files and configurations are correct:

npm run build

Note: If you need to create a presentation, refer to using openpress-create-slide. If deployment is needed, use openpress-deploy after confirmation.