Kopfwelt Skills

Agent skills by Kopfwelt — design thinking facilitation, and workflow skills for keeping track of work in flight, writing it up, and getting it shipped. Documentation lives at kopfwelt.com/skills.

Skills

Skill	Category	What it does
design-thinking-methods	facilitation	Selects the right design thinking method for your situation, renders it as an interactive workshop canvas, and analyzes the results to propose the next step. Canvases render in the conversation language.
wip	workflow	Builds one board of everything in flight — open PRs, branches without a PR, stray worktrees, uncommitted work, review requests, parked handoffs — derived from git and GitHub instead of maintained by hand.
issue	workflow	Turns a finding into a GitHub issue that someone can act on: verified against the code, categorized in the repo's own label set, given one severity, cross-referenced — and checked against the open and closed issues before anything is created.
ship	workflow	Takes work from the working tree to a reviewed pull request — branch, commits, push, PR, merge-conflict resolution, and a code review whose findings are judged before they are applied. Optionally waits for a GitHub Copilot review.

Installation

Claude Code (plugin)

Add the marketplace once, then install from it:

claude plugin marketplace add kopfwelt/skills
claude plugin install kopfwelt-skills@kopfwelt

The id after @ is the marketplace name from .claude-plugin/marketplace.json — kopfwelt — not the repository path. Installing before the marketplace is added fails with "not found in marketplace", which reads like a stale cache but means it was never added.

Updating is two steps — run both, or a newly released skill may stay invisible:

claude plugin marketplace update kopfwelt
claude plugin update kopfwelt-skills

The first refreshes the marketplace's copy of this repo, the second installs from it. Whether plugin update refreshes the marketplace on its own is not documented, so do not rely on it. Applying either needs a restart of Claude Code.

Any agent (copy skill files)

npx skills@latest add kopfwelt/skills

claude.ai (single skill upload)

Each skill can be packaged as a zip for claude.ai (Settings → Capabilities → Skills):

./skills/<category>/<skill-name>/scripts/package.sh

Repository layout

.claude-plugin/         # plugin + marketplace manifest (Claude Code)
skills/
  <category>/
    <skill-name>/
      SKILL.md          # entry point: triggers + process
      references/       # progressive-disclosure knowledge base
      assets/           # e.g. canvas renderer
      scripts/          # per-skill tooling

Skills are self-contained: everything a skill needs at runtime lives in its own folder. See each skill's README for its architecture.

Contributing / adding a skill

1. Create skills/<category>/<skill-name>/SKILL.md (frontmatter: name, description).
2. Add the path to skills in .claude-plugin/plugin.json.
3. Add a row to the table above.
4. Run python3 scripts/check_frontmatter.py (needs pyyaml; CI runs it on every PR). Frontmatter values must be plain scalars that a strict YAML parser accepts — no : inside a value, and no >-, | or quotes, because the kopfwelt.com skill pages read them line by line. Use an em dash where a colon would go.

License

MIT — see LICENSE.