kanban-lite: Skill for Claude Code

Kanban Storage Plugin Author

Use this skill to create a new installable npm package that kanban-lite can load as an external storage provider.

The goal is not just to explain the plugin system. The goal is to leave the user with a real package scaffold that:

• builds successfully,
• exports the correct plugin objects,
• includes setup docs,
• and can be selected from .kanban.json.

What this skill should produce

Create a package directory with, at minimum:

• package.json
• tsconfig.json
• src/index.ts
• README.md
• optional tests if the user wants them or the implementation is concrete enough to verify

The package should normally export one or both of:

• cardStoragePlugin
• attachmentStoragePlugin

Every package must also export a pluginManifest constant. The engine uses this manifest for fast, reliable capability discovery:

export const pluginManifest = {
  id: 'kl-plugin-storage-example',
  capabilities: {
    'card.storage': ['example'] as const,
    'attachment.storage': ['example'] as const,
  },
} as const

The manifest declares the package id, the capability namespaces it provides, and the provider ids for each capability. Optionally add an integrations array when the package also contributes standalone.http, cli, mcp.tools, sdk.extension, or event.listener surfaces.

If the attachment provider supports efficient append-heavy workloads (for example card logs), it may also implement the optional hook:

• appendAttachment(card, attachment, content)

First move

Before writing files:

1. Check whether the current workspace is the kanban-lite core repo or a separate plugin repo.
2. If the kanban-lite docs are present, read the plugin references before scaffolding:
   • https://github.com/borgius/kanban-lite/blob/main/docs/plugins.md
   • https://github.com/borgius/kanban-lite/blob/main/README.md (Storage Providers / plugin sections)
3. Prefer creating a new package directory rather than editing kanban-lite core files, unless the user explicitly asks for an in-repo package.