Using Skill Creator to Generate a Skill for Splitting PDF Documents by Chapter

Preparations

Before using CodeArts Agent, create a project to store various files in the project. After the project is created, enable the auto approval function. In this way, AI will automatically perform related operations without manual intervention.

1. Log in to CodeArts Agent by referring to Quick Start.
2. Create a project for storing files.
   1. On the top menu bar of the IDE, choose File > New > Create Project to go to the page for creating a project.
   2. Select a path for storing the project, enter the project name (for example, pdf-skill-demo), and click OK.

      The project name must start with a letter, and can contain a maximum of 64 characters. Letters, digits, hyphens (-), and underscores (_) are allowed.

      After the project is created, you can view the created PDF-SKILL-DEMO project under EXPLORER.

3. (Optional) Select the agent running mode and authorize automatic operations.
   1. Click in the upper right corner of CodeArts Agent IDE to go to the Settings page.
   2. Choose Chats > Agents > Terminal Command Running Mode, select the running policy for the agent to execute terminal commands. This section uses the default running policy (Running in Sandbox).
   3. Choose Chats > Auto-approve, and click to enable the required items.

      After authorization, tasks for generating complex project-level code are executed automatically. Without authorization, some operations will need your manual confirmation when you code with CodeArts Agent.

      

      Enabling auto approval can lead to operational risks. Assess these risks carefully first and only enable this feature in a secure and trustworthy environment.

      Table 1 Parameters for auto approval

      Parameter	Description	Example
      Edit	Allows the agent to call tools like edit, write, and deleteFile to edit files on your computer.	Enabled
      Browser Access	Allows the agent to access websites in the browser.	Enabled
      Web Crawler	Allows the agent to access and capture specified web page content.	Enabled

   4. Exit the current page to complete the authorization.

Installing Skill Creator in the Marketplace

1. Click in the upper right corner of CodeArts Agent IDE to go to the Settings page.
2. In the navigation pane on the left, choose Skills and Rules.
3. Click Marketplace. On the displayed page, locate Skill Creator.
4. After specifying the skill, click , set the installation location to Project, and click OK.

   After the installation is successful, next to the skill changes to Installed.

Generating a PDF-Splitting Skill

1. In the input box on the CodeArts Agent chat panel, enter the following prompts and click :

   Invoke Skill Creator to generate a professional PDF-splitting skill by chapter based on the following rules:
   [Triggering rules]
   - Enable the skill as long as a user says "Split the PDF by chapter", "Split and name the PDF by chapter title", or "Split the PDF chapters."
   [Execution rules]
   - Automatically identifies chapter titles and boundaries in PDF files.
   - Splits the original PDF into multiple independent PDFs by chapter.
   - Names each split file with the corresponding chapter name.
   [Delivery requirements] No page loss or incorrect splitting. Return all split files after the operation is complete.

2. Confirm the creation information, select "Proceed with creation" – Create the skill with the above name and path, click Submit, and wait until the skill is successfully created.

   After the skill is created, the pdf-split-by-chapters skill package is generated in the PDF-SKILL-DEMO directory under EXPLORER.

   Figure 2 Viewing the generated skill package
   

3. Place the PDF to be split in the current project directory and enter the following prompt in the text box on the chat panel:

   Invoke pdf-chapter-splitter to split the PDF of the CodeArts Agent user guide by chapter.

   Click . CodeArts Agent will help you split the PDF.

   Figure 3 Splitting completed
   
   Figure 4 Viewing the splitting result in the corresponding directory
   
   

   The graph shown here is for reference only. The actual output may vary.

Prompt Optimization

In the previous section, the prompts for generating skills provide basic core functions, which can only be used to perform simple splitting. There are no unified standards for chapter identification, naming, or exception handling. When the content of a PDF document is complex or batch processing is required, issues such as decreased recognition accuracy, prolonged processing time, and naming exceptions often occur.

You can optimize the prompts, for example, specifying the chapter identification style and adding prerequisite file validation rules, splitting requirements, naming rules, and exception messages. This ensures that skills can be executed in a way that better meets your business needs and can run stably and reliably over the long term.