create-cowork-plugin

Vytvoření pluginu pro Claude Cowork

Tento skill provede vytvořením nového pluginu pro Claude Cowork. Schéma pluginu je sdílené s Claude Code — stejný adresář funguje v obou prostředích. Liší se jen dodání (.plugin ZIP) a governance (org settings / org-plugins/).

Kdy použít

Když chceš založit nový plugin do interního marketplace Fullsys, nebo když potřebuješ vědět, jak má plugin vypadat (struktura, manifest, skills, MCP).

Rychlý start (Windows / PowerShell)

Pokud pracuješ v repozitáři cowork-plugins-marketplace, použij scaffold skript — vytvoří plugin ze šablony templates/plugin-template a doplní metadata:

# Z kořene repozitáře:
.\tools\New-CoworkPlugin.ps1 `
    -Name "muj-plugin" `
    -Description "Krátký popis účelu pluginu." `
    -SkillName "muj-skill"

Vznikne plugins/muj-plugin/ s manifestem, ukázkovým skillem a .mcp.json. Pak plugin zaregistruj do katalogu .claude-plugin/marketplace.json (položka name + source).

Struktura pluginu (zdroj pravdy = adresář)

muj-plugin/
├── .claude-plugin/
│   └── plugin.json        # POVINNÉ: manifest
├── skills/                # skills/<name>/SKILL.md (+ references/, examples/, scripts/)
├── agents/                # *.md (v Coworku "uncommon")
├── .mcp.json              # definice MCP serverů (odchozí hranice)
└── README.md

⚠️ Komponentní adresáře (skills/, agents/) jsou vždy v rootu pluginu, nikdy uvnitř .claude-plugin/. Všechny názvy v kebab-case (malá písmena, číslice, pomlčky).

Manifest .claude-plugin/plugin.json

Jediné povinné pole je name (kebab-case). Doporučená: version (semver, start 0.1.0), description, author.

{
  "name": "muj-plugin",
  "version": "0.1.0",
  "description": "Krátký popis účelu pluginu.",
  "author": { "name": "Fullsys" },
  "keywords": ["fullsys"]
}

Skills (skills/<name>/SKILL.md)

Markdown + YAML frontmatter. Povinné name a description (3. osoba, konkrétní trigger fráze v uvozovkách). Volitelné metadata. Název ve frontmatteru musí odpovídat názvu adresáře. Tělo do ~2 000 slov; detaily do references/ (progressive disclosure).

---
name: muj-skill
description: >
  This skill should be used when the user asks to "...". Konkrétní trigger fráze.
metadata:
  version: "0.1.0"
---

MCP servery (.mcp.json) a bezpečnostní hranice

Plugin nikdy nevolá externí služby přímo ze skillu — veškerý odchozí provoz jde přes interní MCP server (HTTPS). Princip „no direct outbound calls from skills — use MCP servers".

{
  "mcpServers": {
    "muj-mcp": {
      "type": "http",
      "url": "${MUJ_MCP_URL}",
      "headers": { "Authorization": "Bearer ${MUJ_MCP_TOKEN}" }
    }
  }
}

• Žádné credentials v repu — používej expanzi ${ENV_VAR} a ${CLAUDE_PLUGIN_ROOT} pro cesty.
• V Coworku přidává remote MCP servery jen admin (managedMcpServers); uživatel je nemůže přidat.

Bezpečnost dat Fullsys (povinné)

V pluginech, skillech a příkladech nikdy reálná PII, EIC/EAN/POD, čísla smluv, receptury, šarže ani mzdy — pouze placeholdery: customer-12345, EIC 27XG000000000001, RECIPE-001, BATCH-001, [email protected], <DB_PASSWORD>. Pro testovací data Bogus s prefixem Test_.

Další kroky

1. Validace → skill validate-cowork-plugin (.\tools\Test-CoworkPlugin.ps1 -Path .\plugins\muj-plugin).
2. Zabalení / publikace → skill package-cowork-plugin.
3. Katalog → přidej položku do .claude-plugin/marketplace.json a otevři PR.