OpenCowork Documentation

The pdf skill is a comprehensive toolkit designed for high-density, industry-standard PDF manipulation. It allows for extracting text and tables, creating new PDF documents, merging or splitting existing documents, and handling PDF forms. It is optimized for scenarios where an agent needs to programmatically process, generate, or analyze PDF documents at scale.

Role for AI Agents: When using this skill, the agent should act as a Professional Document Architect and Technical Editor, focusing on information-rich, structured, and compact layouts.

The OpenCowork.Native.Worker is a sidecar process designed to handle native, backend-heavy workloads that are too expensive to run in the Electron main process. It is intended to host tasks such as:

• Tool calls
• Database maintenance
• Local indexing
• Patch operations
• Parts of the agent runtime

Communication with the main process occurs via IPC (Inter-Process Communication) using length-prefixed MessagePack frames, ensuring that large payloads (like DB, file, or git data) do not interfere with stdout or stderr.

The csv-pipeline skill allows you to process, transform, analyze, and report on CSV, TSV, and JSON (including JSON Lines) files. It is designed for ETL workflows, data cleaning, and generating summary statistics without requiring external dependencies beyond Python 3.

Requirements:

• Python 3 must be installed and available in your environment.
• The tool uses only the Python standard library (csv, json).

Supported File Formats:

• CSV
• TSV
• JSON
• JSON Lines (jsonl)

The product-design-prototype skill is used to create frontend-only, interactive websites or applications. It is specifically designed to route requests for building prototypes from URLs, images, mockups, Figma files, existing code, or abstract ideas that require visual exploration.

Key Constraint: The Golden Rule of Prototyping You must not begin building until you have a visual target. A visual target is defined as:

• A user-provided image.
• A source URL.
• An ImageGen design selected by the user.

Note that a $get-context brief is not a visual target. If no visual target is provided, you must use the $ideate workflow to generate options first.

The product-design-user-context skill allows you to load, manage, and save product and design references (such as Figma files, URLs, screenshots, and design tokens) to ground future Product Design work. This ensures that ideation, prototypes, audits, and critiques match your specific product context by default.

Use this skill when you need to:

• Set up or onboard with Product Design.
• Save product or design sources (URLs, Figma, assets).
• See what Product Design currently remembers.
• Update saved product or design context.
• Set Product Design preferences.

A cultural and vivid style best for consumer apps, food platforms, and community products.

• Palette: Vivid folk colors: hot pink (#FF1493), cobalt blue (#0047AB), sun yellow (#FFE000), and emerald (#009B77).
• Typography: Bold, warm, rounded type.
• Composition: Patterns, repetition, and layered compositions with rich visual texture.
• Motion: Joyful, celebratory motion; elements bounce, pop, and spin into place.
• Transitions: Swirl Vortex or Ripple Waves (hypnotic).
• GSAP Signature: back.out(1.6), elastic.out(1, 0.5). Intentional overshoots.

Folk Frequency: Hot pink #FF1493, cobalt blue, sun yellow, emerald. Bold rounded type.
Pattern and repetition throughout. Layered, dense, handcrafted feeling.
Swirl Vortex or Ripple Waves transitions. Joyful, celebratory energy.

When launching codex exec from a long-running local server, batch runner, or MCP-backed generation path, you must prevent the child process from inheriting an interactive or open parent stdin.

Failure to close or redirect stdin can cause the preflight to hang indefinitely without producing marker files or stderr.

Implementation Requirements

• Python subprocess.run(...): Pass stdin=subprocess.DEVNULL.
• Python subprocess.Popen(...): Pass stdin=subprocess.DEVNULL.
• Node execFile(...): Use a Python runner that enforces stdin redirection for its own codex exec children.

Warning: If a preflight hangs with no output, do not increase the preflight timeout first; check the stdin configuration instead.

Product Design work should be grounded in existing project context to avoid reinventing existing patterns.

• Primary Source: If a user-context.md file exists in the environment, use it by default.
• Contextual Elements: Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, design tokens, brand assets, and component references to ground all work.
• Visual Grounding: When performing ideation, prototyping, audits, clones, or critiques, always attach or include relevant saved screenshots, tokens, or design language to ensure visual fidelity.

When authoring GSAP timelines for HyperFrames, you must adhere to these rules to ensure the framework can control playback and nesting correctly:

1. Initialize Paused: All timelines must start with { paused: true } so the player can control playback.
2. Register Timelines: You must register every timeline on the global object: window.__timelines["<composition-id>"] = tl.
3. Avoid Manual Nesting: The framework automatically handles sub-timeline nesting; do not attempt to manually add them.
4. Duration Source: The composition duration is driven by the data-duration attribute, not the GSAP timeline length.
5. No Empty Tweens: Never create empty tweens solely to set or extend the duration of a timeline.