Widget Preset System Skill

Manage Perch widget layouts via predefined protocol and registry registration.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/tukuyomil032/Perch --skill widget-preset-system-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Widget Preset System Skill
Source: https://github.com/tukuyomil032/Perch/tree/main/.agents/skills/widget-preset-system
Command: npx skills add https://github.com/tukuyomil032/Perch --skill widget-preset-system-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PerchWidget, and includes scripts (resource) components.

What problem does it solve?

This Skill allows users to define and manage custom widget layouts for Perch's Dynamic Island, providing a personalized and efficient experience.

Core Features & Use Cases

  • Widget Customization: Implement custom widgets to extend Perch's functionality.
  • Layout Management: Organize widgets into user-defined presets for quick access.
  • Use Case: If you need a specific set of widgets for your daily tasks, you can create a preset that includes the widgets you need, and quickly switch to it with a single click.

Quick Start

Define a new widget layout by creating a new PerchWidget struct and registering it in the AppDelegate.

Frequently Asked Questions about Widget Preset System Skill

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

FAQPage Schema
How do I create custom widget layouts for Perch's Dynamic Island on macOS?

To create custom widget layouts for Perch's Dynamic Island, define a new PerchWidget struct and register it in the app's AppDelegate. This allows you to organize widgets into user-defined presets for quick access and personalized management.

How does the PerchWidget protocol work for widget customization?

The PerchWidget protocol requires you to implement a new struct and register it in the app's widget registry. This mechanism enables you to define custom widget layouts and manage them through a predefined protocol for Perch's Dynamic Island.

Can I manage multiple widget presets for different tasks on macOS?

Yes, you can organize widgets into user-defined presets for quick access. If you need a specific set of widgets for daily tasks, you can create a preset that includes the necessary widgets and quickly switch to it with a single click.

Do I need the PerchWidget dependency to implement Dynamic Island widgets?

Yes, implementing custom widgets requires the PerchWidget dependency. You must define a new widget layout by creating a new PerchWidget struct and registering it in the AppDelegate to manage configurations for Perch's Dynamic Island.

What is the best way to organize widgets into presets for quick access?

The best way to organize widgets into presets is to group specific widgets needed for your daily tasks into a user-defined layout. By registering a custom PerchWidget struct, you can quickly switch to this preset with a single click.

Why does my custom widget layout not show up in Perch's Dynamic Island?

Custom widget layouts will not appear if the PerchWidget struct is not properly registered in the app's widget registry or AppDelegate. You must ensure implementation of the predefined protocol and complete registration for the layout to function.