trim-init

Discover Penpot files via MCP and create .trim/config with component mappings.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill trim-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trim-init
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-trim/skills/trim-init
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill trim-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize trim for a project by discovering Penpot files via MCP, creating .trim/config, and scanning existing components for initial mappings.

Core Features & Use Cases

  • Discover Penpot files via MCP and select a target file to configure.
  • Create and write .trim/config, and generate initial component mappings for existing Penpot components.
  • Ensure idempotent operation, report file status (blank or populated), and support re-runs to update configuration.

Quick Start

Run /trim:trim-init to initialize Trim with the selected Penpot file.

Frequently Asked Questions about trim-init

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

FAQPage Schema
How do I initialize trim for a Penpot project?

To initialize trim for a Penpot project, run the tool to discover Penpot files via MCP, select a target file, and it will automatically generate the .trim/config and components.json files.

What does trim initialization do with existing Penpot components?

Trim initialization scans existing Penpot components by counting pages and components to determine if the file is blank or populated, then builds initial component mappings saved to .trim/components.json.

Can I re-run trim initialization without overwriting my existing config settings?

Yes, you can safely re-run trim initialization because the process is idempotent, meaning it preserves your existing user settings in the .trim/config file while updating the configuration.

Do I need MCP to connect to Penpot files for trim configuration?

Yes, you need MCP to discover and read Penpot file contents during trim configuration, as the tool relies on this protocol to access the target file and generate initial mappings.

How does trim handle blank versus populated Penpot files during setup?

Trim handles Penpot files by reading their contents and counting the number of pages and components, which determines whether the file is blank or populated before building the configuration.