A universal framework that uses TypeScript decorators to make application functions natively controllable by AI agents with full type safety.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install supernal-interface
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install supernal-interface using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Supernal Interface?
Supernal Interface is a developer-centric framework designed to simplify the process of making software AI-controllable. By providing a suite of decorators like @Tool and @ToolProvider, it allows developers to expose internal application logic directly to Large Language Models without writing complex boilerplate. This framework is essential for those building agentic workflows and looking to leverage Openclaw Skills to create more interactive, autonomous user experiences.
The library acts as a bridge between your application's business logic and various AI interfaces, supporting popular adapters like CopilotKit. It ensures that any function decorated within your codebase is automatically discoverable and callable by AI assistants, maintaining strict type safety and structural integrity throughout the interaction lifecycle.
Supernal Interface Use Cases
- Exposing existing TypeScript methods as AI-callable functions for agentic automation.
- Integrating context-aware chat interfaces into React applications using the ChatUIProvider.
- Synchronizing application state with AI actions through specialized React hooks like useToolBinding.
- Implementing persistent AI memory and state across user sessions using custom storage adapters.
- Scaling AI capabilities within enterprise environments by utilizing Openclaw Skills for standardized tool definitions.
How Supernal Interface Works
- Developers apply the @Tool decorator to class methods, defining the name, description, and category for the AI to understand.
- An adapter, such as the CopilotKit adapter, is initialized to bridge the decorated functions with the AI agent's communication protocol.
- The application is wrapped in a ChatUIProvider, which manages the conversational context and tool registration.
- When a user interacts with the AI, the framework automatically translates the AI's intent into function calls, executing the decorated methods with the correct arguments.
- React hooks manage the real-time feedback loop, updating the UI state based on the AI's tool execution results.
Supernal Interface Setup
Install the core library using your preferred package manager:
npm install @supernal/interface
Once installed, you can begin decorating your services and wrapping your root component with the provided adapter and provider to enable Openclaw Skills functionality.
Supernal Interface Data Schema & Taxonomy
Supernal Interface organizes its operational data through a structured schema that maps code-level metadata to AI-readable formats:
| Metadata Type | Description |
|---|---|
| @Tool Definition | Captures method name, description, and parameter types for LLM function calling. |
| Adapter Config | Determines how tools are registered (e.g., autoRegisterTools: true). |
| State Schema | Manages persisted user preferences and session data via LocalStorage or custom databases. |
| Gherkin Schema | Utilized for generating automated tests and verifying AI behavior against business requirements. |
Supernal Interface Advanced Features
- Multi-model routing to dynamically select the best LLM for specific tool calls.
- Story system integration for boosting AI performance by up to 80% during complex workflows.
- Automated architecture visualization to map how AI agents interact with your application tools.
- Support for custom storage adapters to integrate with enterprise-grade databases.
- Deep integration with Openclaw Skills to ensure compatibility with a wide range of AI agent protocols.
SKILL.md
Loading
Related Openclaw Skills
si (Supernal Interface CLI)
A comprehensive developer tool for automated contract scanning, test generation, and seamless AI agent integration via MCP.
Supernal Coding CLI (sc)
A comprehensive CLI for automating developer workflows, task management, and autonomous agent execution.
ClawX Agent Verification
A comprehensive verification and identity management system for AI agents via the ClawX OAuth framework.
Apple Notes Skill
A comprehensive automation utility for programmatically extracting, monitoring, and exporting Apple Notes content into structured formats.
Universal Command
A unified framework to define command logic once and automatically deploy it across CLI, Next.js APIs, and Model Context Protocol (MCP) tools.
SerpAPI Unified Search
A unified search interface providing structured data from over 20 search engines including Google, Amazon, and Yelp.
Featured*
