GearScope functional log: contentful/skill-kit
Host: macOS 26.5.1 aarch64, Node 24.13.1
Date: 2026-07-21
=== Build workflow skill (node mode) ===
$ npx skill-kit build examples/get-to-know-you/src/skill.ts -o skill --mode node
Bundling for Node.js...
get-to-know-you.mjs
Build complete.
Output: SKILL.md, package.json, bin/get-to-know-you.mjs, scripts/run, references/fun-facts.md
=== CLI session mode: start ===
$ ./scripts/run start --session new
{"sessionId":"86fb156bccbe11a4bac319e8e3c2a525","file":".../skill-kit-sessions/skill-kit-86fb....jsonl","line":2}
Line 2: step=greet, prompt=Hey there!..., schema {name: string}
=== CLI session mode: advance greet -> ask-role ===
$ ./scripts/run advance --session --step greet --output '{"name":"Alice"}'
stderr: [get-to-know-you] greet -> ask-role
stdout: 4 (line ref into session JSONL)
Session line 4: step=ask-role, prompt=
options: dev/Developer, designer/Designer, manager/Manager, other/Something else
schema {role: enum[designer,dev,manager,other]}, completed: {step:greet, response:{name:Alice}}
=== MCP stdio server: initialize ===
$ printf initialize-request | ./scripts/run mcp --host claude-code
{"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":true}},
"serverInfo":{"name":"get-to-know-you","version":"1.0.0"},"instructions":"This MCP server runs..."}}
=== MCP stdio server: tools/list ===
$ printf initialize + notifications/initialized + tools/list | ./scripts/run mcp --host claude-code
tools: [get-to-know-you (namespaced), start, advance]
=== Build reference skill (ts-patterns) ===
$ npx skill-kit build examples/ts-patterns/src/skill.ts -o /tmp/ts-patterns-build --mode node
Build complete: ts-patterns.mjs
=== Reference progressive disclosure ===
$ ./scripts/run topics
generics, discriminated-unions, builder-pattern, error-handling
$ ./scripts/run topic error-handling
| pattern | use | note |
| try/catch | External APIs, I/O | Catch specific error types |
| Result | Domain logic | Forces caller to handle both paths |
| Custom Error class | Typed error codes | Extend Error, add fields |
| never in switch | Exhaustive matching | Compile-time missing-case check |
=== Linter (skill-kit check) on flagship example ===
$ npx skill-kit check examples/get-to-know-you/src/skill.ts
no-host-tool-names [ask-stack]: references host tool "question" directly.
no-host-tool-names [ask-hobby]: references host tool "question" directly.
2 error(s) found. (exit 0)
=== NOT tested ===
- bun standalone build mode (default): bun not installed on host
- live agent-host integration (Claude Code, Cursor, Codex): no host available in test env