Plugin Best Practices

Agent-plugin design conventions for public outcomes, private implementation, and minimal packaging. Use when creating, restructuring, or reviewing agent-skill plugins.

BastiDood 220f2a6 4 files · 3.2 KB Updated

File contents

Plugin Best Practices

Prefer fine-grained plugins that package one coherent installable capability or body of guidance. Consumers install the plugin as a unit instead of assembling cooperating skills or accepting unrelated functionality.

Treat a plugin as an encapsulation boundary. Like a class in object-oriented programming, it exposes a deliberate public interface while hiding implementation details that consumers do not need to understand or invoke.

A plugin can expose one public skill or several independently useful public skills. Those entry points own consumer-facing outcomes while private skills support them without exposing the internal call graph.

Effective Strategies for Focused Agent-Skill Plugins

Follow the guidelines below. Read each linked reference that applies to the plugin design task.

  1. Expose public outcomes while keeping implementation skills private.
  2. Package only the metadata and files that consumers need.

BastiDood/skills/tree/main/plugins/meta/skills/plugin-best-practices commit 220f2a69d4

Frequently asked questions

npx skillmds@latest add bastidood/plugin-best-practices