Si

What This Skill Does

The Supernal Interface (si) CLI is a robust orchestration layer designed to streamline the lifecycle of contract-driven development, testing, and system integration within modern web and mobile applications. It specializes in bridging the gap between application source code and test infrastructure by extracting architectural metadata from Next.js routes, component identifiers, and Swift views. By utilizing @Tool decorators and Gherkin-based story files, the skill automates the generation of comprehensive test suites, significantly reducing manual boilerplate while ensuring that application contracts remain consistent throughout the development lifecycle.

Installation

To integrate this skill into your environment, use the OpenClaw management command: clawhub install openclaw/skills/skills/ianderrington/si Additionally, ensure the base CLI dependency is installed globally in your environment: npm install -g @supernal/interface

Use Cases

The primary utility of the 'si' skill lies in its ability to maintain high-quality architectural standards. It is ideal for developers who need to:

1. Maintain strict route contracts in Next.js, ensuring that navigation structures and component prop-drilling are verified automatically.
2. Standardize data-testid patterns across large codebases to ensure reliable E2E testing with tools like Playwright.
3. Conduct Behavior Driven Development (BDD) by recording and validating story-based tests directly from feature files.
4. Ensure compliance between mobile app interfaces (SwiftUI) and their corresponding navigation logic.
5. Validate the integrity of the system via graph-based analysis to detect orphaned routes or broken internal links before they impact production.

Example Prompts

1. "Use si to scan the ./src/pages directory and generate a fresh routes contract file at ./src/routes/Routes.ts."
2. "Generate Playwright E2E tests based on the existing @Tool decorators found in my index file at src/tools/index.ts."
3. "Run a full graph validation to ensure all routes in the application are reachable and there are no orphan components."

Tips & Limitations

To maximize efficiency, utilize the '--watch' flag during active development to generate contracts in real-time as your codebase evolves. However, keep in mind that this skill is strictly for contract and test infrastructure; do not attempt to use it for generic task management or CLI generation, as it is purpose-built for validation and generation workflows. Always verify your generated test output before committing, especially when using auto-commit flags, to ensure the generated logic aligns with your intended system behavior.