Welcome to bl1nk Skill Builder
Relevant source files
The following files were used as context for generating this wiki page:
bl1nk Skill Builder is a comprehensive desktop IDE specifically designed for AI development, enabling developers to create, manage, and test AI skills, agents, and Model Context Protocol (MCP) tools. Built as a monorepo, the platform provides a specialized environment for transforming general-purpose AI models into specialized agents equipped with procedural knowledge and tool integrations.
The platform functions as a "VS Code for AI development," offering modular workflows for domain expertise, automated documentation initiatives, and a robust CI/CD infrastructure to ensure high code quality and security.
Sources: README.md:1-5, README.md:14-16, Comprehensive.md:5-9, skill/skill-creator/SKILL.md:10-14
System Architecture
The bl1nk Skill Builder architecture is based on a monorepo structure utilizing pnpm for workspace management. It follows an event-driven design with type-safe APIs connecting the desktop interface to a localized backend.
Core Components
The system is divided into two primary applications and a shared logic layer:
- Frontend (Desktop Client): Built with Electron, Next.js 15, and React 19. It handles the IDE interface, including the Skill Editor, Chat Interface, and Settings.
- Backend (Server): A Node.js server using tRPC and Express. It manages CRUD operations for skills, version history, and API credentials.
- Shared Packages: Contains common TypeScript schemas and utility functions used by both client and server.
Sources: README.md:14-18, Comprehensive.md:25-33, specs/001-skill-builder-core/quickstart.md:158-175
High-Level Architecture Diagram
The following diagram illustrates the interaction between the Desktop Application and external AI providers.
Skill Development Life Cycle
Skills in bl1nk are modular packages that extend AI capabilities. They consist of instructions, bundled resources (scripts/assets), and specialized workflows.
Anatomy of a Skill
Every skill follows a standard directory structure:
- SKILL.md: Required file containing YAML frontmatter metadata (name, description) and Markdown instructions.
- Scripts: Executable code for deterministic reliability.
- References: Documentation loaded into context as needed to inform AI thinking.
- Assets: Templates, images, or boilerplate code used in the final output.
Sources: skill/skill-creator/SKILL.md:21-30, skill/skill-creator/SKILL.md:37-45
Progressive Disclosure System
To manage token limits efficiently, bl1nk uses a three-level loading system:
| Level | Content | Context Impact |
|---|---|---|
| Metadata | Name and Description | ~100 words (Always in context) |
| Body | SKILL.md instructions | <5,000 words (Loaded on trigger) |
| Resources | Scripts/References/Assets | Unlimited (Loaded as needed) |
Sources: skill/skill-creator/SKILL.md:79-87
AI Chat Modes and Roles
bl1nk incorporates a sophisticated system prompt architecture that changes behavior based on the active chat mode.
Operational Modes
- Build Mode: The AI acts as an editor that modifies code in real-time. It uses specialized tags like
<bl1nk-write>and<bl1nk-add-dependency>to perform file operations. - Ask Mode: Focused on technical guidance and conceptual explanations. It is strictly prohibited from producing code snippets or making file changes.
- Agent Mode: Acts as an App Builder Agent that gathers requirements, researches APIs, and prepares documentation before the coding phase begins.
Sources: apps/client/src/prompts/system_prompt.ts:68-80, apps/client/src/prompts/system_prompt.ts:211-230, apps/client/src/prompts/system_prompt.ts:285-295
Mode Comparison Flow
This sequence diagram shows how the system switches behavior based on the user's intent.
Data Persistence and Security
Database Schema
The platform uses SQLite (Phase 1) with Prisma/Drizzle ORM for localized data storage.
| Table | Description |
|---|---|
| Skill | Stores the core skill definition and metadata. |
| SkillVersion | Maintains a history of changes for restoration and auditing. |
| ApiCredential | Encrypted storage for AWS and OpenRouter keys. |
| AppSettings | Key-value pairs for global IDE configuration. |
Sources: Comprehensive.md:43-48, Comprehensive.md:126-132, README.md:45-48
Security Standards
The platform implements a "Hardened" security profile for credential management:
- Encryption: API credentials are encrypted using AES-256-GCM.
- Authentication: JWT-based authentication for API access.
- Client Isolation: Context isolation within the Electron container to prevent unauthorized filesystem access.
Sources: README.md:83-88, Comprehensive.md:144-150
Automation and CI/CD
The project utilizes a multi-workflow GitHub Actions strategy to maintain a high health score.
Workflow Summary
| Workflow | Trigger | Function |
|---|---|---|
| CI Pipeline | Push/PR | Lints code, runs unit tests (Vitest), and E2E tests (Playwright). |
| Electron Release | Git Tags | Builds signed/notarized installers for Win, Mac, and Linux. |
| Docker Build | Manual/Tag | Generates multi-platform container images. |
| Security Scan | Weekly/Push | Executes CodeQL analysis and dependency vulnerability checks. |
Sources: Comprehensive.md:17-23, Comprehensive.md:154-170, specs/main/plan.md:130-145
Summary
Welcome to bl1nk Skill Builder, a robust environment for the next generation of AI development. By combining a flexible monorepo architecture with specialized AI roles and comprehensive automation, bl1nk provides developers with the tools necessary to move beyond simple prompts into the creation of complex, specialized AI agents. Whether you are building new skills, managing API credentials, or automating releases, bl1nk ensures a secure and efficient development lifecycle.