How to build a plugin from scratch in Cowork

Build a Cowork plugin from scratch to encode your team's workflows, institutional knowledge, and tool connections into a repeatable, shareable process.
  • Category
    Professional
  • Product
    Cowork
  • Reading time
    Watch time
    5
    min
    min
  • Share
    Copy link
    https://claude.com/resources/tutorials/how-to-build-a-plugin-from-scratch-in-cowork

A Cowork plugin is a group of files that can teach Claude how to do a specific job — encoding your methodology, your workflows, your tool connections.

Anthropic publishes pre-built plugins for common roles like Sales, Finance, and Legal. Customizing those with your company's context can help tailor the plugin to your needs. Building from scratch is for when your team has workflows, processes, or institutional knowledge that existing plugins don't cover.

To learn more about installing and using plugins in Cowork, visit here.

Why build from scratch

  • Your workflow doesn't map to an existing plugin. Your workflow has specifics that an existing plugin doesn't cover, and customizing one doesn't close the gap.
  • You want to encode institutional knowledge for your team. The way your team actually does things — your standards, your judgment calls, your process docs — packaged so everyone works from the same playbook.
  • You need Claude to coordinate across your tools. Your workflow pulls from a particular combination of data sources, applies particular criteria, and produces a particular deliverable.

What's inside a plugin

A plugin can include a few types of components. Claude builds the right combination based on what you describe.

Skills — domain knowledge Claude draws on based on relevance.

A skill might be a few lines describing a formatting preference, or a detailed methodology covering your full review framework.

Skills can also carry supporting reference documents — playbooks, compliance frameworks, pricing matrices — that Claude loads when relevant. Claude reads each skill's description and draws on it when it matches what you're working on.

Commands — structured workflows triggered by typing / in your prompt.

Commands can instruct Claude how to complete a process or produce an output. A single plugin often includes several commands for different parts of the same function.

Commands can accept inputs, so /close-package North America and /close-package Europe run the same process with different scope. Recurring commands can run as scheduled tasks with your criteria applied each time. Commands can also chain to each other, where the output of one feeds the next.

Connectors — link Claude to your tools.

A plugin works without connectors — you can upload data manually or describe the situation — but connected tools let Claude pull what it needs mid-workflow and write results back.

You can direct Claude to search broadly across a connected tool or look in a specific place, depending on what the workflow needs.

Sub-agents — specialized helpers for complex tasks.

One agent might research a company while another pulls data from your CRM and a third scans Slack for context. They can run in parallel or in sequence, each with its own focus and fresh context window.

How to create a plugin

Understanding the components within a plugin can give you a framework for what to share while building one: your knowledge and judgment calls become skills, your repeatable tasks become commands, your data sources become connectors. If you have existing documents or examples of deliverables you've been happy with, share them — Claude maps it to the relevant parts of the plugin.

In Cowork, describe the plugin you want to build — even a sentence is enough to start.

__wf_reserved_inherit

A simpler start works too — Claude will follow up with questions about your workflow, your tools, your standards, and how you handle edge cases.

"I need a plugin for our customer success team"

What changes with a plugin

With detailed instructions, Claude can handle many of these workflows. A plugin packages them into commands anyone on the team can run.

Finance

"Here's our P&L. Materiality threshold is $25K. Decompose by price, volume, and mix. Check these GL accounts against the subledger. Format the JE with debits on top."
Without a plugin: Claude can handle it, but restating your full close methodology every session is overhead that compounds, and the output might vary depending on who's giving Claude the instructions.
/monthly-close North America
With your plugin: Skills load your chart of accounts, materiality thresholds, close calendar, and narrative standards. Connectors pull from your data warehouse. The command runs the full process — a new analyst runs it and gets consistent rigor.

Sales

"Pull usage data for Meridian Health from our analytics dashboard. Check for support escalations in the last 90 days. Compare their current contract against our pricing tiers. Score the renewal risk and flag expansion opportunities."
Without a plugin: You're directing Claude to each source, restating your scoring criteria, and specifying the output format every time.
/renewal-score Meridian Health
With your plugin: Skills hold your scoring criteria and competitive positioning. Connectors pull from your CRM and analytics dashboard. Claude scores the account and flags expansion opportunities — consistent quality whether a senior rep or a new hire runs it.

Legal

"Review this vendor agreement. Our standard on indemnification is capped at 2x contract value. Flag auto-renewals over 12 months. Use GREEN/YELLOW/RED."
Without a plugin: This prompt covers a few checks on one contract. A full review applies dozens of standard positions across every clause type, and you'd need to restate all of them for each new agreement.
/due-diligence
With your plugin: Skills hold your standard positions across every clause type and your severity classifications. A connector accesses the data room. Claude reviews every document against your playbook and produces a risk-rated summary.

Refining your plugin

  • Use it on real work and refine as you go. If you run a command and something's off — a step is missing, the criteria need adjusting, the output format isn't right — tell Claude and it can update the plugin files directly. Looking through the files after Claude builds them can also help spot gaps early.
  • Show Claude the deliverable. Upload an example or point Claude to one in a connected drive. Claude picks up the structure, emphasis, and formatting directly.
  • Keep skills focused. Claude composes multiple skills when a task spans several areas, and focused skills with specific descriptions tend to activate more reliably than broad ones. If a skill isn't loading when you expect, its description is likely too vague — structure it as what it does, when to use it, what it covers.
  • Consider sub-agents for multi-source or long-running tasks. If a workflow pulls from several tools at once, or if a task regularly hits context limits from processing too much in one pass, sub-agents let Claude split the work across separate context windows.

Things to know

  • Plugins work in Cowork, not Chat. Your plugin's skills and commands are active in the Cowork tab.
  • Plugins live on your machine. They don't sync across devices or to teammates automatically. You can share them as a compressed file, host them on GitHub for automatic updates, or have an admin provision them across your org. Learn more about sharing plugins.
  • Skills and connectors can also live outside plugins. If you have personal context that applies across everything you do in Cowork — not tied to one plugin — you can add standalone skills and connectors in settings.

Cowork with plugins is available as a research preview for all paid Claude plans (Pro, Max, Team, Enterprise) on macOS and Windows. Browse available plugins.

Learn more