> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kowalah.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kowalah Plugin

> Bundles the Kowalah Claude Connector with seven skills for running your AI Operating Model, so Claude can read your vision map, diagnose a process, and log opportunities.

The Kowalah Plugin puts your AI Operating Model inside Claude. It bundles the [Kowalah Claude Connector](/integrations/mcp/overview) with seven skills that know how to read your map honestly, talk a process through, and take an idea to your Kowalah team in a form the triage queue can actually use.

Install it once and Claude stops being a general assistant and starts being someone who knows your organization's vision, your processes, your constraints, and what is already in flight.

<Info>
  **This plugin needs a Kowalah engagement.** Every tool is scoped to the organizations you belong to. Signing in creates an account if you do not have one, but the skills have nothing to show until your account is attached to your company's Kowalah organization. If you are looking for something that works without a Kowalah account, see the free [Concierge Plugins](/integrations/plugins/overview).
</Info>

## Who it is for

<CardGroup cols={3}>
  <Card title="AI programme leads" icon="gauge">
    You are accountable for AI across the organization or a division. Where is the business constrained, is the work in flight aimed there, what happens next.
  </Card>

  <Card title="Process owners" icon="workflow">
    You own a real business process. Where does the time actually go, does this need redesigning or automating, how do you know the AI is doing it right.
  </Card>

  <Card title="Everyone else" icon="users">
    You have no formal role in the map. Talk through your own work, find where AI could help, and log what is worth doing.
  </Card>
</CardGroup>

<Tip>
  Everyone in your organization can **read** the whole operating model, whatever their role, and can **propose** a change to any process they can see. What you can edit directly depends on where you sit. See [Your operating model in Claude](/integrations/mcp/operating-model).
</Tip>

## What's included

Seven skills, plus the Kowalah Claude Connector wired up and ready to authenticate.

| Skill                 | What it does                                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/programme-review`   | Coverage, where constraints concentrate, and whether the work in flight is aimed at the actual gaps. Tests everything against your AI vision map. |
| `/process-diagnostic` | Reads one process honestly. Where cycle time really goes, how many handoffs, and what has never been measured.                                    |
| `/process-redesign`   | Takes a process from as-is to a proposed to-be, held beside the original so the two can be compared.                                              |
| `/quality-bar`        | Acceptance criteria, gates and monitors, target scores. What "good" means for a step, set by you rather than by whoever builds it.                |
| `/spot-opportunities` | Talk through your own work, find the real friction, check what already exists, and route it.                                                      |
| `/raise-opportunity`  | Checks the accelerator library first, tests the idea against your vision, scores it, submits it.                                                  |
| `/kowalah-setup`      | Connects the server and tells you what your account can actually see.                                                                             |

You do not have to remember the names. The skills activate on their own when the conversation fits, and typing `/` in a task shows the full list.

<Accordion title="Two ideas the skills are built around" icon="lightbulb">
  **A null is "can't say", never "none".** Process diagnostics return blanks where the data is incomplete, for example a handoff count when a step has no owner, or a cycle ratio when a step has never been timed. The skills surface those gaps rather than rounding them to zero, because an unmeasured process reading as a healthy one is the expensive mistake.

  **Work is measured in minutes, processes are measured in days.** A process that is 0.4% work and 99.6% waiting cannot be fixed by making the work faster. Where the data supports it, the diagnostic leads with that ratio, because it usually changes what the conversation is about.
</Accordion>

## Install it

You can add the plugin yourself, or an administrator can put it in front of everyone. Both work in Claude on the desktop app or in a browser. You do not need to switch to Cowork first.

<Tabs>
  <Tab title="Add it yourself">
    This connects Claude straight to our repository, so you get new versions as we ship them.

    <Steps>
      <Step title="Open Plugins">
        In Claude, open **Customize** in the left sidebar, then **Plugins**.
      </Step>

      <Step title="Add the Kowalah marketplace">
        Click **Add**, then **Add marketplace**. Paste:

        ```
        https://github.com/kowalah-dev/kowalah-plugin
        ```

        Leave **Sync automatically** turned on so you pick up new versions when we publish them, then click **Sync**.
      </Step>

      <Step title="Install it from Discover">
        Open the **Discover** tab, find **Kowalah**, and click **Add**.

        Before you install, the plugin's page shows you exactly what you are getting: the skills it adds, the connector it enables, and its version. Worth a look.
      </Step>

      <Step title="Sign in with your work email address">
        The first time a skill uses the connector, Claude prompts you to authenticate. Use your work email. The email domain is what places you in your company's organization, so a personal address cannot reach it. If you do not have a Kowalah account yet, one is created for you.
      </Step>

      <Step title="Run /kowalah-setup">
        Start a new chat and type `/kowalah-setup`. It confirms the connection and tells you which organization you landed in, what your role can see, and whether anything needs fixing before you go further.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Roll it out to everyone">
    For Claude Team and Enterprise administrators. Upload it once and your members find it in their own **Discover** tab, with no links to share and nothing for them to download.

    <Info>
      Only Claude workspace **Owners** and **Primary Owners** can manage organization plugins.
    </Info>

    <Steps>
      <Step title="Download the .zip">
        Download [kowalah-plugin.zip](https://18evqetn8qvaaj3d.public.blob.vercel-storage.com/plugins/kowalah-plugin.zip). That link always points at the current release.

        <Warning>
          **Safari users:** Safari can automatically unzip downloads, which breaks the upload because Claude needs the .zip, not the expanded folder. Either re-compress the folder into a .zip, or go to **Safari > Settings > General** and untick **Open safe files after downloading**.
        </Warning>
      </Step>

      <Step title="Open the plugins admin">
        Go to **Organization settings > Plugins**, click **Add plugins**, and choose **Upload a file**.
      </Step>

      <Step title="Choose a marketplace">
        Add it to your existing organization library, or create a new marketplace and name it, for example `Kowalah Plugins`.
      </Step>

      <Step title="Upload and set who gets it">
        Upload the .zip, then set the installation preference:

        | Preference               | What members see                                                   |
        | ------------------------ | ------------------------------------------------------------------ |
        | **Available to install** | Appears in their **Discover** tab. They install it themselves.     |
        | **Installed by default** | Appears in their installed list automatically. They can remove it. |
        | **Required**             | Installed and cannot be removed.                                   |
        | **Not available**        | Hidden. Useful while you test.                                     |

        **Available to install** suits most rollouts. People who want it find it, and nobody gets a connector they did not ask for.
      </Step>

      <Step title="Tell people where to find it">
        Members open **Customize > Plugins > Discover**, find **Kowalah**, and click **Add**. They sign in with their work email on first use, then run `/kowalah-setup`.
      </Step>
    </Steps>

    <Warning>
      **Updates are not automatic on this path.** Members stay on whatever version you last uploaded. When we release a new version, upload the new .zip to the same marketplace. Because the plugin name matches, it overwrites the previous version with no need to delete the old one first.

      If you would rather not track releases, point people at the **Add it yourself** tab instead. Adding our repository as a marketplace keeps them current automatically.
    </Warning>
  </Tab>
</Tabs>

<Note>
  Want to read the source before you install it? The plugin is public at [kowalah-dev/kowalah-plugin](https://github.com/kowalah-dev/kowalah-plugin). Every skill is plain markdown, so you can browse the repository, or drop the expanded folder into a Claude conversation and ask what it does. Past versions and release notes are on the [releases page](https://github.com/kowalah-dev/kowalah-plugin/releases).
</Note>

## If the skills return nothing

The most common problem is not a broken install. It is an account that authenticated successfully but landed in a new, empty organization rather than your company's existing one.

This happens when your email domain is not yet registered with your company's Kowalah organization. Claude signs you in, creates an organization for you, and every skill then returns valid but empty results with nothing to explain why.

<Warning>
  **The organization's name will not tell you.** A new organization is named from your email domain, so signing up on a work address produces one named after your own employer. It can look entirely legitimate and still be empty.
</Warning>

Run `/kowalah-setup` and it checks for this. The signs are all of these together:

* exactly one organization, and your role in it is **admin**
* an operating model with one unit and no processes
* no vision map
* no projects, deliverables or Expert Requests, despite that admin role

If that is what you see, your account needs attaching to the right organization. Your Kowalah contact or your organization's AI lead can sort it out. Nothing in the plugin can fix it from your side.

## Troubleshooting

<Accordion title="I can't see the plugin after uploading" icon="circle-question-mark">
  Restart Claude Desktop. The plugin should appear under **Customize > Plugins** in the Cowork sidebar.
</Accordion>

<Accordion title="Slash commands aren't appearing" icon="slash">
  In a task, type `/` or click the **+** button. Only skills from installed plugins appear in the menu. If the plugin is installed but the skills still are not showing, uninstall and reinstall from the downloaded .zip.
</Accordion>

<Accordion title="Claude says my operating model is empty" icon="map">
  Two different things look identical here. Either no operating model has been mapped for your organization yet, which is work your Kowalah team does with you during Define, or your account is in a new empty organization, covered above. Run `/kowalah-setup` to tell them apart.
</Accordion>

<Accordion title="Upload rejected" icon="triangle-alert">
  The file must be a valid .zip under 50 MB. If your browser expanded the archive, re-compress the folder into a .zip before uploading.
</Accordion>

## Related

<CardGroup cols={2}>
  <Card title="MCP Server" icon="plug" href="/integrations/mcp/overview">
    The connector underneath the plugin, and how to set it up on its own
  </Card>

  <Card title="Your operating model in Claude" icon="map" href="/integrations/mcp/operating-model">
    Reading the map, talking a process through, and what you can change
  </Card>

  <Card title="Available tools" icon="wrench" href="/integrations/mcp/available-tools">
    What each connector tool does and how your role affects it
  </Card>

  <Card title="Concierge Plugins" icon="puzzle" href="/integrations/plugins/overview">
    Free role-based plugins that work without a Kowalah account
  </Card>
</CardGroup>