skills.rest
getpaseo
getpaseoOFFICIAL
Explore all skills by this author →
GitHub

paseo-plugin

Build, install, and manage trusted local Paseo plugins with React Native surfaces and RPC handlers.

15.7k|1.7k|Updated Oct 13, 2025
Search Tags:#CLI#zod#react native#RPC#daemon#paseo#Plugin Development
One-click install
npx skills add https://github.com/getpaseo/paseo --skill paseo-plugin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paseo-plugin
Source: https://github.com/getpaseo/paseo/tree/main/skills/paseo-plugin
Command: npx skills add https://github.com/getpaseo/paseo --skill paseo-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @getpaseo/plugin, @getpaseo/plugin/server, react, react-native, @tanstack/react-query, zod.

What problem does it solve?

Extending the Paseo agent interface requires knowledge of its plugin contract, theming rules, RPC system, and daemon lifecycle. This Skill guides the creation, installation, reloading, and troubleshooting of Paseo plugins so contributions work correctly across desktop, mobile, and web clients.

Core Features & Use Cases

  • Plugin scaffolding and lifecycle: Initialize projects with paseo plugin init, then typecheck, install, reload, enable, disable, and remove plugins via the CLI.
  • UI contributions: Add workspace panels, sidebar surfaces, and command center items using React Native primitives with theme-aware colors and compact layout handling.
  • Daemon-side RPCs and attachments: Define Zod-validated RPC contracts with defineRpc, register subprocess handlers, and contribute composer attachment sources while keeping credentials on the daemon.
  • Use Case: A developer wants a sidebar counter panel plus a backend RPC that reads daemon config. The Skill walks through scaffolding the project, registering the surface and handler, typechecking, installing, and verifying the plugin reaches running status.

Quick Start

Ask the AI to create a new Paseo plugin with a sidebar surface and install it on the local daemon.

Frequently Asked Questions about paseo-plugin

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

FAQPage Schema
How do I create a Paseo plugin?▼

Run `paseo plugin init /absolute/path/to/my-plugin`, then `npm install` in the generated directory. Default-export a contribution function receiving a PluginContext, register surfaces or panels, run `npm run typecheck`, and install with `paseo plugin install`.

How do I add a sidebar surface to a Paseo plugin?▼

Register the surface with `plugin.addSurface("main", Component)` before adding the sidebar item via `plugin.addSidebarItem` with a matching surface id. Components use React Native primitives and must color text from theme.colors and pad from layout.compact.

Which modules can Paseo plugin client code import?▼

Client bundles may import react, react-native, @tanstack/react-query, zod, @getpaseo/plugin, and @getpaseo/plugin/server. Paseo supplies these at runtime; install them locally only for typechecking. Other packages work only in daemon-side handlers.

Why is my Paseo plugin sidebar item missing?▼

Common causes are targeting the wrong host, the plugin not reaching `running` status, an invalid Lucide icon name, or a sidebar item pointing to an unregistered surface. Check `paseo plugin ls` for status and `paseo plugin logs <id>` for errors.

Do Paseo plugin source edits require a daemon restart?▼

No. Run `paseo plugin reload <id>` after editing source; restarting the daemon can kill the agent performing the work. Only changes to the global pluginsEnabled config switch require `paseo reload`.

Are Paseo plugins sandboxed or safe to install?▼

No. Plugins are trusted, unsandboxed code whose backend handlers can access files, processes, credentials, and network services on the daemon machine. Only install plugins you have authorized and whose source you have inspected.

Related Skills

Explore More Software Engineering Skills→
getpaseogetpaseo
12.9k

paseo-loop

Automate iterative worker-verifier cycles with the Paseo daemon.

Official
Intermediate
juanrejuanre

publish-skills

Publish and update pgdbm Claude Code skills with version bumps.

Community
Basic
FoundupFoundup
2

unicode_daemon_monitor_prototype

Monitors YouTube daemon output for Unicode rendering failures and applies WRE recursive improvement fixes.

Community
Advanced
MSApps-MobileMSApps-Mobile
8

youtube-transcriber

Extract YouTube video and playlist transcripts with timestamps from browser captions.

Official
Advanced