@tanstack/ai-code-mode-skills weekly downloads statistics

@tanstack/ai-code-mode-skills

Persistent skill library for TanStack AI Code Mode - LLM-created reusable code snippets.

Overview

The Skills System extends Code Mode with persistent, LLM-creatable reusable code snippets. Skills are TypeScript functions that the LLM can create, catalog, and invoke across sessions—enabling compounding capability over time.

Installation

Usage

Testing

This package includes a CLI for testing the skills system. The tests verify the complete skills lifecycle:

1. First run (Skill Creation): LLM uses execute_typescript to solve a problem and registers a reusable skill 2. Second run (Skill Reuse): LLM calls the saved skill directly without needing execute_typescript

Running the Simulated Test

The simulated test uses a mock adapter with predetermined responses for fully deterministic testing. No API key required.

Running the Live Test

The live test uses a real LLM (OpenAI or Anthropic) to verify the skills flow with actual LLM responses.

Setup

1. Copy the environment example file:

2. Edit test-cli/.env.local and add your API key:

Run the test

CLI Commands

API Reference

codeModeWithSkills(options)

Creates Code Mode tools and system prompt with skills integration.

Options:

• config - Code Mode tool configuration (driver, tools, timeout, memoryLimit) • adapter - Text adapter for skill selection (should be a cheap/fast model) • skills.storage - Skill storage implementation • skills.maxSkillsInContext - Maximum skills to load into context (default: 5) • messages - Current conversation messages • skillsAsTools - Whether to include skills as direct tools (default: true)

Returns:

• registry - Mutable ToolRegistry containing execute_typescript, skill management tools, and selected skill tools • systemPrompt - System prompt documenting available skills and external functions • selectedSkills - Skills that were selected for this request

Storage

The worker/browser-safe in-memory storage (createMemorySkillStorage) is re-exported from the root entry. The Node-only file storage (createFileSkillStorage) imports node:fs / node:path, so it is only available from the /storage subpath — keeping the root export safe to import from Cloudflare Workers and browser bundlers:

createFileSkillStorage(options)

Git-friendly file-based storage:

createMemorySkillStorage(options)

In-memory storage for testing.

Trust Strategies

Skills track execution success and promote trust levels over time:

| Trust Level | Description |

| untrusted | Newly created, not yet proven | | provisional | 10+ executions with ≥90% success | | trusted | 100+ executions with ≥95% success |

Available strategies:

• createDefaultTrustStrategy() - Earn trust through successful executions • createAlwaysTrustedStrategy() - Trust immediately (dev/testing) • createRelaxedTrustStrategy() - Faster promotion • createCustomTrustStrategy(options) - Custom thresholds

License

MIT