> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# SoMark Skill

> Add the somark-document-parser skill to Claude Code, Cursor, Cline, and 40+ other AI coding assistants

[somark-document-parser](https://github.com/SoMarkAI/somark-document-parser) is the simplest path when you want to reuse SoMark inside a Skill-capable agent platform without wrapping upload and parsing logic yourself. If you are still comparing Skill, MCP, API, CLI, and SDK, start with the [get started overview](/en/documentation/get-started-overview).

<Steps>
  <Step title="Install">
    You can install it from any of these sources:

    **GitHub**

    ```bash theme={null}
    npx skills add https://github.com/SoMarkAI/somark-document-parser
    ```

    **skills.sh**

    ```bash theme={null}
    npx skills add https://github.com/somarkai/somark-document-parser --skill somark-document-parser
    ```

    **clawhub.ai / OpenClaw**

    ```bash theme={null}
    openclaw skills install somark-document-parser
    ```

    Compatible with Claude Code, Cursor, Cline, OpenCode, and [40+ other AI agents](https://skills.sh).
  </Step>

  <Step title="Set up your API key">
    Get an API key at [somark.tech](https://somark.tech), then set it as an environment variable:

    ```bash theme={null}
    export SOMARK_API_KEY=sk-your-api-key
    ```

    You can also configure it in your agent's settings. The skill will guide you through setup on first use.

    <Note>
      SoMark includes a free tier (500 pages/day, 2000 pages/month) that is automatically credited to your account. After the free quota is exceeded, the system automatically switches to paid quota.
    </Note>
  </Step>

  <Step title="Use prompts that trigger the Skill more reliably">
    To trigger the SoMark skill more reliably, your prompt should usually make three things explicit:

    * "Use SoMark to parse this PDF and return Markdown output."
    * "Call the SoMark skill to parse this contract, extract the key clauses, and preserve heading structure."
    * "Call SoMark to parse this paper and tell me the core idea of the paper."
  </Step>

  <Step title="Keep the limits in mind">
    | Constraint         | Limit  |
    | ------------------ | ------ |
    | Max file size      | 200 MB |
    | Max pages per file | 300    |
    | QPS per account    | 1      |
  </Step>
</Steps>