lark-slides

Create and edit Lark Feishu slide presentations via lark-cli XML APIs.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-slides-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-slides
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-slides
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-slides-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Creating and editing Feishu (Lark) slide presentations programmatically requires mastering a complex XML schema, token resolution, image upload rules, and error-prone shell escaping; this Skill encodes the full workflow so an agent can reliably build, read, and modify decks. ## Core Features & Use Cases - Presentation creation and editing: Create decks with slides +create, add pages via xml_presentation.slide create, and perform block-level edits with +replace-slide without changing page order. - Planning and validation pipeline: Enforces a slide_plan.json planning layer, visual/asset planning rules, and a post-creation validation checklist with XML overlap linting. - Templates, icons, and diagrams: Ships a template search/summarize/extract tool, an offline IconPark icon search index, and whiteboard guidance for flowcharts and architecture diagrams. - Use Case: A user pastes a Feishu /slides/ or /wiki/ URL and asks to rewrite three pages; the Skill resolves the token, reads the current XML, applies block-level replacements, and verifies the result. ## Quick Start Ask the agent to create a Feishu presentation on your topic with a target page count and style, and it will plan, generate, and validate the deck using lark-cli.

Frequently Asked Questions about lark-slides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Feishu slide presentation from the command line?

Use lark-cli slides +create with a title, optionally passing --slides as a JSON array of slide XML strings. For complex decks, create a blank presentation first, then add pages one by one with xml_presentation.slide create.

How do I edit a single element on an existing Feishu slide?

Read the page with xml_presentation.slide get to find the block's short ID, then call the +replace-slide shortcut with a block_replace or block_insert action. This changes only that block without altering page order.

Can I use external image URLs in Feishu slides XML?

No, img src only accepts file_token values from Feishu drive. Download web images locally first, upload them with slides +media-upload or the @./path placeholder in +create, then write the returned token into the XML.

Why does a Feishu wiki link fail when used as a presentation ID?

Wiki URLs contain a wiki_token, not an xml_presentation_id. Query the node with lark-cli wiki spaces get_node, confirm obj_type is slides, and use the returned obj_token as the real presentation ID.

What does Feishu slides error 3350001 mean?

Error 3350001 indicates invalid parameters, commonly a block_id that no longer exists in the current slide or malformed XML. Re-read the slide with slide.get to get fresh block IDs and validate the XML structure before retrying.