OpenPress

AI agent integration

Skills

OpenPress exposes underlying primitives to agents via built-in skills, while external creative skills possess capabilities for reception, taste, examples, starter files, and domain judgment.

Boundaries. OpenPress is not responsible for fetching starters or operating a template marketplace. Please use Agents to install skills and adapt starter files into your Workspace.

This document explains how to install and utilize various Skills in OpenPress.

Step 1: Understand Available Skills

OpenPress provides several different types of Skills to meet the needs of different workflows:

  • System Operations: openpress (CLI usage, validation, export, routing), openpress-upgrade (package upgrades and migration QA), openpress-deploy (deployment).
  • Document Creation: openpress-create-pages (A4 and other page documents), openpress-create-slide (presentation documents).
  • Review: /apply-comments (processing inline comments).
  • External starters: install separate starter-bearing skills when a project needs opinionated examples or reusable starter files.

Step 2: Install External or Creative Skills

To refresh the built-in OpenPress skills in an existing workspace, run:

npm run openpress:skills
# or, in core-only workspaces:
node node_modules/@open-press/core/engine/cli.mjs skills:sync .

If you need special designs or templates (e.g., social cards), you can install external skills via npx. For example, to install a social card skill:

npx -y skills@latest add quan0715/openpress-social-card-skill

Step 3: Apply Skill via Agent

Once installed, please direct your Agent to use the skill:

  1. Instruct the Agent to read the skill’s SKILL.md documentation.
  2. Have the Agent copy or adapt the starter files provided in the skill’s starter/ directory into your OpenPress Workspace.
  3. If it’s a page or slide creation skill, ask the Agent to generate the corresponding press.tsx and directory structure according to the official instructions.

Step 4: Validate Skill Output

No matter which Skill you use to establish the structure or introduce content, be sure to run a build before finishing to verify the project’s health:

npm run build