Promptles
Clarity

Match the Part to the Job

Pick the part by who starts it: Claude (skill), a person (slash command), every event (hook), another system (MCP server).

A plugin can hold different kinds of parts, and each one starts a different way: a skill Claude loads when a request matches it, a slash command a person types, a hook that runs on every matching event, and an MCP server (a connector to another system). Say who should start the behavior and why, so Claude picks the right part. Vague: "Add a style check to the plugin." Specific: "The style check must run after every file edit without anyone asking, so make it run automatically on each edit, not something Claude decides to use. Show me it firing on one edit."

Where you'll practice this

One Promptles scenario teaches this principle directly.

  • Match the Part to the Job

    The shipkit brief is approved and lists five behaviors in `brief-behaviors.md`. A plugin can bundle several kinds of parts, and each kind starts in a different way. Dana's draft plan makes all five behaviors into skills, including the lint check (an automatic style and error…

Other principles in Clarity