Examples
@contentful/skill-kit ships with three bundled examples that demonstrate different skill patterns.
get-to-know-you (Workflow)
A playful interview skill that asks the user a series of questions and produces a developer trading card. This example demonstrates the full workflow builder API: params, the store with graph-aware type narrowing, act.askUser (both structured and open), act.confirm, declarative branching based on role selection, render helpers for composing the final card, actions for side effects, loop guards on the hobby collection step, and observers for transition logging.
ts-patterns (Reference)
A TypeScript patterns and idioms reference skill built with the reference() builder. This example demonstrates the reference skill type: topic registration with labels, lazy content loading from references/ files via refs.load(), inline content generation using render.table and render.code, and the progressive-disclosure pattern where the agent surfaces topic content on demand rather than dumping everything at once.
contentful-help (Composite)
A composite skill that dispatches to doctor and setup sub-skills, or resolves FAQ topics directly. This example demonstrates the composite pattern: a dispatcher state machine with act.askUser for intent selection, .subskill() registration with params mapping, .topic() registration for reference content, actions for deterministic environment checks, subskill: and topic: routing from next, step name namespacing, and runComposite for testing.